📖 docs: fix 404 on Reference section and audit every sidebar link

[clubanderson]

Summary

• Fix sidebar section labels so nested folders resolve to the first real leaf page instead of an intermediate folder route.
• Add a regression test covering nested folders that carry their own route and children.
• Audited the live docs sidebar on https://docs.hivecommons.dev/docs/hive/overview/introduction and verified the local fixed sidebar has zero broken links.

Live sidebar audit before fix

Link text	URL	Status	Cause
Reference	https://docs.hivecommons.dev/docs/hive/reference/architecture-decision-records	404	The rendered Reference folder label used the route of its first child folder (Architecture Decision Records) instead of recursing to that folder's first leaf page (ADR index). No page is generated for the intermediate folder route.

All other 72 rendered left-sidebar links returned 200, including section-header links for Community, Overview, Getting started, Operations, Integrating with Hive, Security, Architecture Decision Records, and sibling project entries.

After fix

Link text	Fixed URL	Local status
Reference	http://127.0.0.1:3210/docs/hive/reference/architecture-decision-records/adr-index	200

Local rendered sidebar audit: 73 links checked, 0 broken.

Validation

• npm run test -- DocsSidebar.behavior.test.tsx ✅
• npm run check-links ✅
• npm run lint ✅ (warnings only, pre-existing)
• npm run build ✅
• Local production server audit of every rendered sidebar href: 73 checked, 0 broken ✅

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign clubanderson for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[netlify]

✅ Deploy Preview for hivecommons-docs ready!

Name	Link
🔨 Latest commit	4fed2f8
🔍 Latest deploy log	https://app.netlify.com/projects/hivecommons-docs/deploys/6ac408125b2fe8000892584f
😎 Deploy Preview	https://deploy-preview-225--hivecommons-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.