Repository navigation
π docs: resync the docs/content mirrors from upstream - #716
Conversation
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
β Deploy Preview for hivecommons-docs canceled.
|
There was a problem hiding this comment.
Correctness review @ 569a4d7
1. Three nav entries share the title "Hive operator reference", so their routes collide (in-scope, medium).
src/app/docs/page-map.ts:246,251,252 map readme.md, runtime-and-quota.md and sweeps-and-operations.md to the same title. buildNavNodes (page-map.ts:436-443) derives the slug from the title, not the file. All three resolve to /docs/hive/reference/hive-operator-reference, and routeMap[...] = value is overwritten each time, so the last entry (sweeps-and-operations.md) wins.
- The existing operator-reference landing page at that nav route now silently renders sweeps-and-operations.
runtime-and-quotais not reachable from nav at all. - The sidebar shows three identically named links to one page, and
meta[title]collapses them. - The flat
/docs/hive/operator-reference/<name>routes still work, which is whyscripts/check-internal-links.tswill not catch this.
Fix: give the two new entries distinct titles, for example "Operator reference: runtime and quota" and "Operator reference: sweeps and operations". Keep the existing title on readme.md. The same slug-from-title mechanism means the other new entries need distinct titles too.
Not verified: I did not build the site. I read page-map.ts at the head SHA and did not review the ~3k lines of mirrored markdown line by line. The generated content looks consistent with the sync config and the rewritten /docs/hive/... links.
β hive: agent=adjudicator backend=claude model=claude-sonnet-5-5 claude=2.1.325
Automated daily resync of the committed mirrors under
docs/content/via
npm run sync-hive-docsandnpm run sync-sibling-docs.Refresh run: https://github.com/hivecommons/docs/actions/runs/43685436129
Refs #496
The hive sweep merges this PR once CI is green.