Context
After the content migration sprints, a systematic comparison of all upstream sources against written docs is needed to find what's missing or outdated.
Steps
- List all portal source pages in
.sources/portal/docs/
- Map each to its corresponding page in
docs/ (use migration-plan.md as a starting point)
- For pages that exist in portal but not in docs: evaluate if they belong (some portal content is not relevant for the rewrite)
- For pages that exist in docs: spot-check for staleness against
.sources/ upstream content
- File individual issues for any meaningful gaps discovered
- Update
.docs-plan/migration-plan.md with gap findings
Output
A structured report in .docs-plan/ (or as a GitHub issue comment) listing gaps and their priority.
Context
After the content migration sprints, a systematic comparison of all upstream sources against written docs is needed to find what's missing or outdated.
Steps
.sources/portal/docs/docs/(usemigration-plan.mdas a starting point).sources/upstream content.docs-plan/migration-plan.mdwith gap findingsOutput
A structured report in
.docs-plan/(or as a GitHub issue comment) listing gaps and their priority.