Sprint 2 — Documentation Foundation Validation
Objective and scope
Sprint 2 consolidates the learning, installation, and getting-started experience (Learn, Installation & Getting Started) for developers and teams adopting Rapid OS v3.0.0.
Documentation coverage matrix (Sprint 2)
| Area | Implemented document | Canonical path | Status |
|---|---|---|---|
| What RAPID OS is | What is RAPID OS | docs/concepts/what-is-rapid-os.md | Verified |
| Problem and benefits | Why RAPID OS | docs/concepts/why-rapid-os.md | Verified |
| Core concepts | Core Concepts | docs/concepts/core-concepts.md | Verified |
| Limits and boundaries | Product Boundaries | docs/concepts/product-boundaries.md | Verified |
| System requirements | Requirements | docs/installation/requirements.md | Verified |
| Windows | Installation Windows | docs/installation/windows.md | Verified |
| Linux | Installation Linux | docs/installation/linux.md | Verified |
| macOS | Installation macOS | docs/installation/macos.md | Verified |
| WSL | Installation WSL | docs/installation/wsl.md | Verified |
| Verification | Installation Verification | docs/installation/verification.md | Verified |
| Upgrade | Upgrade | docs/installation/upgrade.md | Verified |
| First project | First Project (Quickstart) | docs/getting-started/first-project.md | Verified |
| Existing project | Existing Project | docs/getting-started/existing-project.md | Verified |
| First Spec | First Spec | docs/getting-started/first-spec.md | Verified |
| First Context | First Context | docs/getting-started/first-context.md | Verified |
| Next steps | Next Steps in Governance | docs/getting-started/next-steps.md | Verified |
| Common problems | Troubleshooting Installation | docs/troubleshooting/installation.md | Verified |
Acceptance criteria (Definition of Done)
- Product Truth: The purpose, capabilities, and limits of Rapid OS are explained clearly, without hallucinated claims of autonomous behavior or LLM-as-a-judge.
- Cross-platform installation: Detailed step-by-step guides for Windows, Linux, macOS, and WSL 2.
- Version differentiation: Explicit distinction between the stable version (
v3.0.0) and the development version (main). - Reproducible Quickstart tutorial: Step-by-step guided tutorial with a minimal project, functionally tested in CI using an isolated temporary directory.
- Adoption in existing repositories: Non-invasive guide that preserves business code and uses
.bakbackups. - Automated contracts and tests: 11 documentation contract tests in Python with no Node.js dependencies, covering file integrity, valid flags, and lockfile consistency.
- RAPID OS test suite intact: 301/301 tests passing.
- Docusaurus build:
npm run typecheckandnpm run buildpass with no type warnings or broken internal links (onBrokenLinks: 'throw').