[Tomasz Naumowicz (tnaum-ms)]

What changed

The documentation site at https://microsoft.github.io/vscode-documentdb/ gets a new theme, cleaner navigation, and a dark mode that follows the OS.

Site and navigation

• Switches from the experimental Minima setup to Just the Docs (remote_theme, v0.12.0): sidebar, search, breadcrumbs, and Microsoft styling (Segoe UI, #0067b8, semibold headings).
• Publishes only the landing page, user-manual/ and release-notes/. Everything else in docs/ (plans, blog drafts, data-flow notes) is excluded.
• Groups the user manual into Connecting to Databases, Data Management, Querying and AI Features. No file moves, so every existing URL still works.
• Replaces the "Back to ..." header on each page with front matter; breadcrumbs take over. Release notes sort newest first.
• Adds an "On this page" panel on the right (starting with Introduction), the documentdb.io favicon, and the DocumentDB icon in the sidebar title.

Dark mode

• The site follows the OS light or dark setting.
• Every screenshot has a _dark variant, swapped with <picture> and prefers-color-scheme. They are rendered from the same framing settings as the light images (the light re-renders match the published images pixel for pixel).
• The two copy-and-paste diagrams in the user manual are redrawn for both themes. The 0.7 release notes now reuse the 1.0 copy-and-paste screenshot.

Readability fixes

• Code blocks: the theme kept the 16px body line height around 12px code, which pulled ASCII diagrams apart. Box-drawing lines now connect.
• #### headings (for example "Step 1: Select an Account") were tiny uppercase labels; they are now body-sized and semibold.

Tooling

• New previewing-docs-site skill: scripts/preview.ps1 serves the site locally with live reload, keeps all build output outside the repository, and fixes the Windows path-casing issue that silently drops the custom styles.
• ESLint treats docs/assets/js as browser code.
• writing-release-notes skill and CONTRIBUTING.md updated for the release notes front matter.

Why

The site is an interim home until the user manual moves to learn.microsoft.com, so the goal is a site that looks right and costs little to maintain, without rewriting content into a site-specific format.

Rejected: PR previews in CI. The old gh-pages preview workflow was removed in c8ad1900; bringing it back would need write access to gh-pages, cleanup, and would leak unreleased pages into the live sidebar and search. A downloadable artifact build was also tried in this PR and dropped: matching the GitHub Pages build closely enough was not worth the extra moving parts. Reviewers preview locally with the previewing-docs-site skill.

Scope

Not in this PR:

• Content rewrites. Pages keep their text; only navigation, styling and images change.
• The landing page still carries its own table of contents, kept in sync with the sidebar by hand.
• Pages now excluded (blog drafts, data-flow notes, localization) will return 404 after deploy. Nothing links to them.

Validation

• Built and reviewed locally with the github-pages gem (the same build GitHub Pages uses), in light and dark mode.
• ESLint and Prettier pass; CI is green.
• Needs a human: the first live GitHub Pages build after merge.

Links

• Design and history: docs/ai-and-plans/features/docs-site/ (README.md, iterations/02-just-the-docs.md)

[github-actions]

✅ CI passed: standard tier (ready PR)

Commit 752f367, workflow run.

Layer	Result	Ran or skipped because
Static checks	✅ passed	every push
Unit tests	✅ passed	every push
npm packages: verify tarballs	⏭️ skipped	no change to packages/**, package-lock.json or the CI workflow
VSIX: inspect contents	✅ passed	ready PR
VSIX: self-test of the checks	⏭️ skipped	no change to build/verification/**, build/vite/**, the Vite configs, package-lock.json or the CI workflow
VSIX: activate in VS Code	✅ passed	ready PR
VSIX: self-test of the activation check	⏭️ skipped	no change to build/verification/**, build/vite/**, the Vite configs, package-lock.json or the CI workflow
Webview host in unbundled extensions	⏭️ skipped	no change to packages/vscode-ext-webview/**, package-lock.json or the CI workflow
E2E	⏭️ not available yet	arrives with the E2E iteration (full tier)

Full run: add the ci:full-requested label to run every layer once on the current commit.
No full run yet.

Code quality

Check	Status	How to fix
Localization (l10n)	✅ Passed	Nothing to fix
ESLint	✅ Passed	Nothing to fix
Prettier formatting	✅ Passed	Nothing to fix

Build size

No page, activation, VSIX or other bundle size changed by 5% or 50 KiB or more against main. VSIX: 8.2 MiB.

Artifacts: VSIX | Bundle-reports-38887904126 | L1-manifest-report-38887904126

All graphs (exact bytes)

Graph	PR bytes	Base bytes	Delta bytes	Delta %
Collection View page (collectionView)	6,035,539	6,035,539	✅ 0	0.0%
Document View page (documentView)	4,808,032	4,808,032	✅ 0	0.0%
Local Quick Start page (localQuickStart)	1,550,255	1,550,255	✅ 0	0.0%
Atlas Credentials page (atlasCredentials)	1,503,880	1,503,880	✅ 0	0.0%
Cluster Dashboard page (clusterDashboard)	1,550,095	1,550,095	✅ 0	0.0%
Activation (mainStartup)	3,447,288	3,447,288	✅ 0	0.0%
Extension host (main)	9,974,006	9,974,006	✅ 0	0.0%
Playground worker (playgroundWorker)	5,384,565	5,384,565	✅ 0	0.0%
VSIX (vsix)	8,635,116	8,635,116	✅ 0	0.0%
playgroundTsPlugin	6,175	6,175	✅ 0	0.0%
viewsEntry	1,455,863	1,455,863	✅ 0	0.0%
viewsAssets	80,340	80,340	✅ 0	0.0%
editorWorker	259,528	259,528	✅ 0	0.0%
jsonWorker	389,389	389,389	✅ 0	0.0%

Packaged bytes. Shared chunks count in every graph that loads them, so rows do not add up.

Updated in place on every run.