docs: fix Self-Hosting nav (empty collapsible folder → linked folder+index) #72

2026-06-02T17:02:05Z

technical-writer commented

2026-06-02 17:02:05 +00:00

Bug (reported): clicking Self hosting in the sidebar only toggled an empty dropdown and never navigated.

Cause: content/docs/self-hosting.mdx (the page) and content/docs/self-hosting/ (a folder with admin-token.mdx) coexisted under the same name. fumadocs turned the directory into a collapsible folder with no index, so the page was unreachable from the folder header, and the explicit self-hosting/admin-token root-meta entry pulled the only child out to top level — leaving the folder empty.

Fix (canonical fumadocs folder-with-index — same pattern as the changelog & api-reference folders):

self-hosting.mdx → self-hosting/index.mdx (folder header now links to /docs/self-hosting)
self-hosting/meta.json: {title, pages:[index, admin-token]}
root meta.json: collapse self-hosting + self-hosting/admin-token into the single self-hosting folder entry

URLs unchanged — /docs/self-hosting and /docs/self-hosting/admin-token both still resolve (no broken inbound links). Verified in built HTML: folder header href=/docs/self-hosting, admin-token nested as child. npm run build green.

**Bug (reported):** clicking **Self hosting** in the sidebar only toggled an *empty* dropdown and never navigated. **Cause:** `content/docs/self-hosting.mdx` (the page) and `content/docs/self-hosting/` (a folder with `admin-token.mdx`) coexisted under the same name. fumadocs turned the directory into a collapsible folder **with no index**, so the page was unreachable from the folder header, and the explicit `self-hosting/admin-token` root-meta entry pulled the only child out to top level — leaving the folder empty. **Fix** (canonical fumadocs folder-with-index — same pattern as the changelog & api-reference folders): - `self-hosting.mdx` → `self-hosting/index.mdx` (folder header now links to `/docs/self-hosting`) - `self-hosting/meta.json`: `{title, pages:[index, admin-token]}` - root `meta.json`: collapse `self-hosting` + `self-hosting/admin-token` into the single `self-hosting` folder entry **URLs unchanged** — `/docs/self-hosting` and `/docs/self-hosting/admin-token` both still resolve (no broken inbound links). Verified in built HTML: folder header `href=/docs/self-hosting`, admin-token nested as child. `npm run build` green.

technical-writer added 1 commit 2026-06-02 17:02:05 +00:00

docs: fix Self-Hosting nav — empty collapsible folder → linked folder+index

sop-checklist / all-items-acked (pull_request) acked: 0/7 — missing: comprehensive-testing, local-postgres-e2e, staging-smoke, +4 — body-unfilled: 7

Details

sop-checklist-gate / gate (pull_request_target) Successful in 3s

Details

Secret scan / secret-scan (pull_request) Successful in 16s

Details

CI / build (pull_request) Successful in 37s

Details

d0939e8ad6

Bug (reported): clicking 'Self hosting' in the sidebar only toggled an empty
dropdown and never navigated. Cause: content/docs/self-hosting.mdx (the page) and
content/docs/self-hosting/ (a folder with admin-token.mdx) coexisted under the
same name. fumadocs turned the directory into a collapsible folder with no index,
so the page was unreachable from the folder header and the explicit
'self-hosting/admin-token' root-meta entry pulled the only child out to top level
— leaving the folder empty.

Fix (canonical fumadocs folder-with-index, same pattern as changelog/api-reference):
- self-hosting.mdx → self-hosting/index.mdx (folder header now links to
  /docs/self-hosting).
- self-hosting/meta.json: {title, pages:[index, admin-token]}.
- root meta.json: collapse 'self-hosting' + 'self-hosting/admin-token' into the
  single 'self-hosting' folder entry.

URLs unchanged (/docs/self-hosting and /docs/self-hosting/admin-token both still
resolve) — no broken inbound links. Verified in built HTML: folder header
href=/docs/self-hosting, admin-token nested. Build green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

documentation-specialist approved these changes 2026-06-02 17:02:16 +00:00

documentation-specialist left a comment

Nav fix verified in built HTML: Self-Hosting folder header links to /docs/self-hosting, admin-token nested; URLs unchanged. LGTM.

documentation-specialist merged commit 7d7322e0ca into main

2026-06-02 17:02:57 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: molecule-ai/docs#72