Permissions and access

There is a Description setting but I cannot find anywhere to type one, and nothing shows

The file picker does not save a description, so none is ever stored or shown.

Cannot find the GitHub macro in Capable's macro list or the command palette

The macro is deliberately hidden from Capable's own listings.

Readers see "Connect a GitHub account with access to this repository to view this file"

The file is in a private repository and that reader has no connected GitHub account that can reach it. Access is always per person. There is no site-wide or admin-level GitHub connection.

Admin wants to connect GitHub once on behalf of the whole site, and cannot find the setting

There is no site-level or admin-level GitHub connection, and no GitHub tab in Capable global or space settings. Everyone connects their own account.

Macro cannot find a file in a repository that still uses "master"

Capable assumes the default branch is "main". Only the Appfire File migrator defaults to "master".

Cannot choose a different branch in the Browse GitHub picker

The file browser has no branch picker. It uses the repository's default branch, or the branch in a link you pasted.

Cannot find a public repository I do not belong to in the picker

Public repositories you are not a member of appear only in search results, and only on the first page. From page 2 onwards you see only your own repositories.

Cannot filter search for image files

Image is a supported file type with its own section in the catalogue, but the File Type filter in search offers only seven options and image is not one of them.

Macro says none of my accounts have access, but I am certain I do

Very likely GitHub rate limiting. When GitHub answers with a 403 error, the macro reports it as an access problem whatever the real reason, and it does not retry or back off.

Cannot find a "Connections" area on the Capable → Github page

There is no Connections area. You connect your GitHub account from the Github file macro on a page.