Improve pull request dashboard docs#19
Conversation
20c5e91 to
8c0904b
Compare
There was a problem hiding this comment.
Pull request overview
This PR is a documentation-only update that clarifies how the Pull Request Dashboard shared workflow operates. It adds a new "What the dashboard tracks" section describing the next-action queues, documents the webhook-incremental / hourly-full-run model and classification cache behavior, and rewrites the manual-run guidance. I verified the prose against the implementation: the four queues match render.py (maintainer/approver/author/external), drafts are rendered in a separate section, the schedule is hourly (cron: "0 * * * *"), and the workflow_dispatch repository input behaves as described. The renamed ## Manual full run heading matches its #manual-full-run anchor reference, and no stale #manual-runs references remain.
Changes:
- Added "What the dashboard tracks" section and notes on webhook incremental runs, hourly full-run backstop, and classification-cache token savings in
README.md. - Renamed/rewrote the "Manual runs" section into "Manual full run" with clearer step-by-step guidance, and tightened wording throughout.
- Added RATIONALE bullets clarifying per-repository state namespacing and cached-classification reuse for unchanged review threads.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| pull-request-dashboard/README.md | Clarifies dashboard queues, run model, opt-in steps, and manual-run instructions; wording cleanup |
| .github/scripts/pull-request-dashboard/RATIONALE.md | Adds notes on state namespacing and cached-classification reuse |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
5b4ce84 to
66f9aab
Compare
66f9aab to
7e34b45
Compare
Clarify the pull request dashboard docs by describing the next-action queues, incremental webhook updates, hourly full-run backstop, classification cache behavior, and manual workflow run guidance.