juddisjudd/svocs

SVOCS is a Markdown-first documentation generator built on SvelteKit and Svelte 5, with static output and optional Svelte components for richer pages. Its default feature set is strong: reusable documentation components, several search backends, build-time social cards, math, Mermaid, theming, llms.txt, sitemap generation, and base-path deployment. The doctor, update, and migration commands are especially useful because they address maintenance rather than only initial scaffolding.

The biggest adoption question is long-term upgrade stability. Template-based projects can drift, so conflict handling, compatibility promises, and escape hatches should be documented and tested. Migration quality would be easier to trust with fixtures covering complex components, links, redirects, localization, and search indexes. Accessibility audits, large-site build benchmarks, and a stable extension contract would further strengthen the project. SVOCS is best for Svelte teams that want a polished static docs experience while retaining plain Markdown; teams with heavily customized existing sites should trial migration on representative content first.