# Documentation site and runnable examples Use this topic for guides, API references, navigation, themes, legacy links, and interactive examples. Development and preview commands are in the [documentation-site README](../../apps/docs/README.md). | Question | Read first | Follow through | | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Public usage, APIs, and compatibility migrations | [Developer guides](../../apps/docs/guide), [API reference](../../apps/docs/reference/index.md), [migration guide](../../apps/docs/migration.md) | [Application/documentation coordination](../../docs/docs-handoff.md), [shared package boundaries](../../docs/architecture.md) | | Site theme, navigation, and source links | [VitePress configuration](../../apps/docs/.vitepress/config.mts), [sidebar](../../apps/docs/.vitepress/sidebar.mts), [theme](../../apps/docs/.vitepress/theme) | [Version and repository links](../../apps/docs/.vitepress/source.mts) | | Legacy documentation paths and redirects | [Legacy path mapping](../../apps/docs/.vitepress/legacy.mts) | [Combined site and legacy redirect artifacts](../../scripts/assemble-pages.mjs), [build and deployment](toolchain.md) | | Inline interaction and source inclusion | [Lightweight Vue examples](../../apps/docs/examples), [admin iframe wrapper](../../apps/docs/examples/AdminExample.vue) | [example.html](../../apps/admin/example.html), [isolated demo bootstrap and routes](../../apps/admin/src/documentation-example.tsx), [admin demo pages](../../apps/admin/src/views/demo) | Lightweight examples use public shared-package entry points. Examples needing application context use the restricted routes and in-memory cache in `example.html`. Display the same source that actually runs. For public contract changes, return to the owning topic and update guides, examples, and migration notes. Targeted verification: `pnpm harness verify docs` runs `docs:check`, covering types, internal links, and the production build. Wording-only corrections can use source review and formatting checks. Use a browser only for affected rendering or interactions, selecting the relevant page/example and dimensions through the [documentation workflow](../../docs/docs-handoff.md#update-workflow). For admin embedding, deployment subpaths, or combined redirect artifacts, generate the combined output with `pnpm pages:build` and preview it as described in the [README](../../apps/docs/README.md).