docs: migrate to Starlight + LikeC4, fix Storybook v10#16
Merged
Conversation
Replace MkDocs (unmaintained since Aug 2024) with Astro Starlight at apps/docs/, and Structurizr DSL (archived CLI) with LikeC4 for C4 architecture diagrams. Starlight: - New apps/docs/ Astro app with full sidebar config matching old nav - Symlinks to existing docs/ — no file moves needed - Pagefind search, Mermaid rendering via rehype-mermaid - Workaround for zod v4 incompatibility (vite.ssr.noExternal) - Add title frontmatter to all 218 doc files for Starlight schema - Convert MkDocs !!! admonitions to Starlight ::: syntax (11 files) LikeC4: - 6 split model files at docs/architecture/likec4/ (L1-L3) - `pnpm docs:c4` exports 8 Mermaid diagrams - `pnpm docs:c4:serve` launches interactive C4 browser - Delete workspace.dsl Also includes: - Storybook scaffolding (.storybook/) - TypeDoc config for @variscout/core API docs - New architecture maps (system, component, data-pipeline) - New workflow maps (analysis-journey, investigation-lifecycle) - Documentation methodology doc Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Resolve all merge conflicts (6 primary + 7 archive/source files): - CLAUDE.md: take main's slim table format, add Starlight/LikeC4 entries - data-flow.md: take main's extended frontmatter + ADR-023 See Also - 05-technical/index.md: merge AI architecture docs + LikeC4 model entry - 07-decisions/index.md: take main's full ADR-001–025 list - 08-products/pwa/storage.md: accept main's deletion - docs/index.md: main's frontmatter + Starlight footer - promptTemplates.ts: apply main's options-object refactor - Archive files: keep Starlight frontmatter + main's disclaimers Post-merge fixes: - Add title frontmatter to 19 new docs from main - Update Starlight sidebar with ADR-014–025, AI architecture, methodology, new workflows, new components - Remove deleted PWA storage and Power BI sidebar entries - Fix remaining conflict markers in user-guide.md and architecture.md Verified: docs:build (246 pages), docs:c4 (8 .mmd files), test (3102 pass) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…rts) addon-essentials and blocks are bundled into storybook core in v10 — remove the separate packages and update manager/preview imports to use the new storybook/* entry points. Delete orphaned ScatterPlot placeholder story. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
9 tasks
jukka-matti
added a commit
that referenced
this pull request
May 14, 2026
- investigations.md "8f followups" entry: STATUS → RESOLVED 2026-05-14, PR #166 squash-merged as cd93691. LOW #16 (Canvas/index.tsx 1122-line refactor) + LOW #19 (brand ProcessHubId) explicitly carried forward. - investigations.md gains two new entries from the --chrome walk: (1) pre-existing setState-in-render warning from AppMain across canvas transitions (App.tsx untouched by #166), (2) designer-lens canvas journey-clarity observations (9 UX items: Frame→Canvas rename, desktop LODSwitcher parity, Lock-canvas mode-toggle relabeling, L1 capability empty-state copy, L3 CTA visual weight, etc.). - decision-log.md "8f canvas viewport SHIPPED" entry: Amendment 2026-05-14 followups complete block prepended; original 2026-05-13 amendment retained as history. Co-Authored-By: ruflo <ruv@ruv.net>
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
apps/docs/with 212 MDX pages covering vision, journeys, features, case studies, technical architecture, design system, ADRs, and product specs@storybook/addon-essentials, explicit addon imports, new story files for all chart and UI components)core,charts,hooks,ui,pwa) plus 3 additional fixes in exifStrip testsDetails
Starlight docs site (
apps/docs/)docs/folder structure@variscout/coreStorybook
TypeScript
exifStriptest type errorsTest plan
pnpm buildsucceedspnpm testpasses (~3,000 tests)pnpm build-storybooksucceedspnpm docs:build— verify Starlight static build🤖 Generated with Claude Code