What problem does it solve? Choosing and operating a documentation platform is error-prone: teams pick stale tools, skip CI quality gates, and ship unsearchable docs. This Skill provides an opinionated, research-backed playbook for platform selection, content architecture, docs-as-code pipelines, and search configuration. ## Core Features & Use Cases - Scored platform selection: A decision tree with hard filters and weighted scoring across Docusaurus v3/v4, Mintlify, GitBook, MkDocs Material, Nextra v4, Starlight (Astro), and Fern, including 2026 status flags like MkDocs Material's maintenance mode. - Diátaxis content architecture: Maps tutorials, how-to guides, reference, and explanation into platform-specific navigation structures, with anti-patterns to avoid. - Docs-as-code CI and search: Ready-to-use GitHub Actions pipelines with Vale prose linting, lychee dead-link checking, preview deploys, and search setup via Algolia DocSearch or pagefind. - Use Case: A SaaS team paying $249/month for GitBook wants to cut costs. The Skill walks through the migration checklist to move 80 pages to a self-hosted Starlight site with redirect maps, CI gates, and built-in pagefind search. ## Quick Start Ask the assistant to help you pick a documentation platform for your project and set up the site with CI and search.
