Skip to content

Commit 0696abd

Browse files
committed
docs: narrow runtime PAT to report repository only (fine-grained PATs include public read by default)
1 parent 48c5bfd commit 0696abd

2 files changed

Lines changed: 3 additions & 3 deletions

File tree

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -142,10 +142,10 @@ The Action reads your public activity and pushes to the `gh-pages` branch. This
142142

143143
| | Fine-grained PAT | Classic PAT |
144144
|---|---|---|
145-
| Repository access | `All repositories` | - |
145+
| Repository access | Your report repository only | - |
146146
| Permissions / Scopes | `Contents: Read & Write` | `repo` |
147147

148-
`All repositories` is required because the tool reads events, PRs, and contributions across all your public repositories, not just the report repository.
148+
Fine-grained PATs always include read-only access to all public repositories on GitHub, so selecting only the report repository is enough. `Contents: Write` is needed to push to the `gh-pages` branch.
149149

150150
### For `npx github-weekly-reporter setup`
151151

docs/manual-setup.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ This guide walks through setting up GitHub Weekly Reporter without the `setup` C
66

77
- A GitHub account
88
- A personal access token (PAT). Since manual setup does not create repositories or set secrets on your behalf, you only need the permissions the Action uses at runtime:
9-
- **Fine-grained PAT** (recommended): repository access **All repositories**, permission `Contents: Read & Write` ([create one](https://github.com/settings/personal-access-tokens/new))
9+
- **Fine-grained PAT** (recommended): select your **report repository only**, permission `Contents: Read & Write` ([create one](https://github.com/settings/personal-access-tokens/new))
1010
- **Classic PAT**: scope `repo` ([create one](https://github.com/settings/tokens/new?scopes=repo))
1111
- An LLM API key for AI-generated narratives (free tiers available from Groq and OpenRouter)
1212

0 commit comments

Comments
 (0)