githubnext / githubnext/gh-aw-workshop

[guidelines] side-quest-06-03c-copilot-github-token-ui-only.md: checkpoint checklist exceeds 10-box limit

Open Beginner friendly
#3,292 0 comments 0 reactions 0 assignees View on GitHub
documentation guidelines
Dominant language
JavaScript
Stars
47
Forks
19
Avg merge
8h 54m
Merged PRs (30d)
50

Description

## File reviewed
`workshop/side-quest-06-03c-copilot-github-token-ui-only.md`

## Violations

### Checkpoint checklist size limit exceeded
**Offending text:**
> - [ ] I can see a newly created PAT in my token list
> - [ ] I copied the token value before leaving the page
> - [ ] I noted the token expiry date
> - [ ] The secret name is exactly `COPILOT_GITHUB_TOKEN`
> - [ ] The secret now appears in the repository Actions secrets list
> - [ ] I closed the token tab only after confirming the secret was saved
> - [ ] You generated a new fine-grained PAT and copied it before leaving the token page
> - [ ] The token has **Copilot requests: Read-only** under **Account permissions**
> - [ ] `COPILOT_GITHUB_TOKEN` exists in **Settings** → **Secrets and variables** → **Actions**
> - [ ] `copilot-requests: write` is not present in the source workflow
> - [ ] The agent recompiled and committed the updated lock file
> - [ ] You set a reminder to rotate the PAT before the expiry date
> - [ ] You understand when to use Method 1 vs Method 2

**Suggested fix:**
The page has 13 checkboxes total across its two "Quick check" mini-checklists (3 + 3) and the final `## :white_check_mark: Checkpoint` section (7), exceeding the "Maximum 10 checkboxes per page" rule in `.github/workflows/guidelines.md`. Trim the two in-page "Quick check" lists down to only the items that aren't already restated in the final Checkpoint (e.g., drop near-duplicates like "I copied the token value before leaving the page" / "I closed the token tab only after confirming the secret was saved" from the Checkpoint since they're already verified inline), or consolidate the Checkpoint list itself to 6–7 outcome-oriented items so the page-wide total is 10 or fewer.

> Generated by [📋 Guidelines Enforcer](https://github.com/githubnext/gh-aw-workshop/actions/runs/34736492618) · copilot · auto · 97 AIC · ⌖ 6.78 AIC · ⊞ 9.5K · [◷](https://github.com/search?q=repo%3Agithubnext%2Fgh-aw-workshop+is%3Aissue+%22gh-aw-workflow-call-id%3A+githubnext%2Fgh-aw-workshop%2Fguidelines-enforcer%22&type=issues)
> - [x] expires on Sep 20, 2026, 3:59 AM UTC

Contributor guide

No contributing guide indexed for this repository

Research direction

Open workshop/side-quest-06-03c-copilot-github-token-ui-only.md and compare its Quick check and Checkpoint lists with the 10-checkbox limit in .github/workflows/guidelines.md. Remove redundant or consolidate outcome-oriented items while preserving the required checks. Count all page checkboxes and confirm the total is 10 or fewer.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
85/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.