Follow-up from PR #38 review; attempted in the unmerged PR #42, so it never landed.
Problem
examples/quarto-publish.yml documents which permissions: can be dropped for a build-only (deploy: false) preview via a block comment rather than per-line hints:
# examples/quarto-publish.yml (current)
# ... (deploy: false) can drop these two and keep just contents: read.
pages: write
id-token: write
A caller copying the stub can easily miss the block comment and leave pages: write / id-token: write in place when they don't need them.
Proposed fix
Move the hint inline so it's impossible to skip:
pages: write # omit when deploy: false
id-token: write # omit when deploy: false
Minor / cosmetic doc nit. Same origin as the abandoned PR #42; companion to the substantive output-dir follow-up.
Follow-up from PR #38 review; attempted in the unmerged PR #42, so it never landed.
Problem
examples/quarto-publish.ymldocuments whichpermissions:can be dropped for a build-only (deploy: false) preview via a block comment rather than per-line hints:A caller copying the stub can easily miss the block comment and leave
pages: write/id-token: writein place when they don't need them.Proposed fix
Move the hint inline so it's impossible to skip:
Minor / cosmetic doc nit. Same origin as the abandoned PR #42; companion to the substantive
output-dirfollow-up.