From cc3c56c492219f12ad74ef72b8f9721b993d01ca Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 1 Jul 2026 01:16:08 +0000
Subject: [PATCH] docs: reconcile nav with filesystem and tidy sidebar

The docs site sidebar had drifted out of sync with the pages on disk,
which read as unmaintained. Reconcile the two and smooth over a few
consistency rough edges:

- Add sidebar entries for pages that existed but were unlinked:
  moq-mux and moq-boy crates, @moq/demo and @moq/boy packages, and the
  CMAF standard. moq-mux was even featured on the homepage yet absent
  from the sidebar.
- Fix the C library "libmoq" link, which jumped into the Rust crates
  section (switching the whole sidebar) instead of staying in /lib/c/.
- Promote the orphaned /demo/ folder to a first-class nav + sidebar
  section, rename Setup's overlapping "Demos" subsection to "Demo Setup"
  so the two stop colliding, and point the homepage "Demo" hero button
  back into the docs instead of off to moq.dev.
- Unify labels: capitalize well-known tech in the Layers list (QUIC,
  WebTransport, WebSocket) while keeping project literals (moq-lite,
  hang), and rename the navbar "Apps" to match the "Applications" page
  title it links to.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QBqk5qwpJmbcWQdDnxNZ4w
---
 doc/.vitepress/config.ts | 26 ++++++++++++++++++++------
 doc/index.md             |  6 +++---
 2 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/doc/.vitepress/config.ts b/doc/.vitepress/config.ts
index 440e64e5d..6eb9bfc26 100644
--- a/doc/.vitepress/config.ts
+++ b/doc/.vitepress/config.ts
@@ -42,7 +42,7 @@ export default defineConfig({
 		nav: [
 			{ text: "Setup", link: "/setup/" },
 			{ text: "Concepts", link: "/concept/" },
-			{ text: "Apps", link: "/bin/" },
+			{ text: "Applications", link: "/bin/" },
 			{
 				text: "Libraries",
 				link: "/lib/",
@@ -56,6 +56,7 @@ export default defineConfig({
 					{ text: "Go", link: "/lib/go/" },
 				],
 			},
+			{ text: "Demos", link: "/demo/" },
 		],
 
 		sidebar: {
@@ -71,7 +72,7 @@ export default defineConfig({
 					],
 				},
 				{
-					text: "Demos",
+					text: "Demo Setup",
 					items: [
 						{ text: "Web", link: "/setup/demo/web" },
 						{ text: "MoQ Boy", link: "/setup/demo/boy" },
@@ -88,9 +89,9 @@ export default defineConfig({
 							text: "Layers",
 							link: "/concept/layer/",
 							items: [
-								{ text: "quic", link: "/concept/layer/quic" },
-								{ text: "web-transport", link: "/concept/layer/web-transport" },
-								{ text: "web-socket", link: "/concept/layer/web-socket" },
+								{ text: "QUIC", link: "/concept/layer/quic" },
+								{ text: "WebTransport", link: "/concept/layer/web-transport" },
+								{ text: "WebSocket", link: "/concept/layer/web-socket" },
 								{ text: "moq-lite", link: "/concept/layer/moq-lite" },
 								{ text: "hang", link: "/concept/layer/hang" },
 							],
@@ -102,6 +103,7 @@ export default defineConfig({
 								{ text: "MoqTransport", link: "/concept/standard/moq-transport" },
 								{ text: "MSF", link: "/concept/standard/msf" },
 								{ text: "LOC", link: "/concept/standard/loc" },
+								{ text: "CMAF", link: "/concept/standard/cmaf" },
 								{ text: "Interop", link: "/concept/standard/interop" },
 							],
 						},
@@ -171,7 +173,9 @@ export default defineConfig({
 										{ text: "moq-native", link: "/lib/rs/crate/moq-native" },
 										{ text: "moq-token", link: "/lib/rs/crate/moq-token" },
 										{ text: "hang", link: "/lib/rs/crate/hang" },
+										{ text: "moq-mux", link: "/lib/rs/crate/moq-mux" },
 										{ text: "web-transport", link: "/lib/rs/crate/web-transport" },
+										{ text: "moq-boy", link: "/lib/rs/crate/moq-boy" },
 										{ text: "libmoq", link: "/lib/rs/crate/libmoq" },
 									],
 								},
@@ -199,6 +203,8 @@ export default defineConfig({
 										{ text: "@moq/publish", link: "/lib/js/@moq/publish" },
 										{ text: "@moq/token", link: "/lib/js/@moq/token" },
 										{ text: "@moq/signals", link: "/lib/js/@moq/signals" },
+										{ text: "@moq/demo", link: "/lib/js/@moq/demo" },
+										{ text: "@moq/boy", link: "/lib/js/@moq/boy" },
 									],
 								},
 							],
@@ -206,7 +212,7 @@ export default defineConfig({
 						{
 							text: "C",
 							link: "/lib/c/",
-							items: [{ text: "libmoq", link: "/lib/rs/crate/libmoq" }],
+							items: [{ text: "libmoq", link: "/lib/c/#libmoq" }],
 						},
 						{
 							text: "Python",
@@ -231,6 +237,14 @@ export default defineConfig({
 					],
 				},
 			],
+
+			"/demo/": [
+				{
+					text: "Demos",
+					link: "/demo/",
+					items: [{ text: "MoQ Boy", link: "/demo/moq-boy" }],
+				},
+			],
 		},
 
 		socialLinks: [
diff --git a/doc/index.md b/doc/index.md
index 27da02ccc..d55a59c17 100644
--- a/doc/index.md
+++ b/doc/index.md
@@ -10,14 +10,14 @@ hero:
       text: Concepts
       link: /concept/
     - theme: alt
-      text: Apps
+      text: Applications
       link: /bin/
     - theme: alt
       text: Libraries
       link: /lib/
     - theme: alt
-      text: Demo
-      link: https://moq.dev/
+      text: Demos
+      link: /demo/
 
 features:
   - icon:
