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

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

What you are seeing

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

#Why it happens

The picker's save routine does not even write the key.

#What to do

Ignore it. Put any explanatory text in normal page content above or below the macro.

#Settings involved

Setting

Where

What it does

There is no GitHub settings screen

Nowhere

The git capability declares no global settings tab and no space settings tab, so GitHub contributes nothing to Capable global settings or space settings. There is also no admin "connect the site to GitHub" screen, becaus

Turn GitHub on or off per space

Space property `<APP_HASH>_capable`, object name `capabilities.alwaysOff` / `capabilities.

AlwaysOff suppresses the byline in that space; alwaysOn shows it even on pages with no GitHub macro. Again, byline only. Macros still render.

#Limits that apply here

Limit

Value

What happens

No caching of file content

-

Every render of a GitHub-file macro re-fetches the file. A page with many GitHub macros consumes GitHub API budget on every view.

No rate-limit handling anywhere

-

There is no retry, no backoff and no Retry-After handling in the capability. A GitHub 403 caused by rate limiting is classified as an access error and reported to the reader as though nobody has acces

File content passes through the server as a

-

Large files can therefore be slow or fail.

Found it? Good.