Run docs like software: pick the tooling by needs (Docusaurus/Mintlify/MkDocs/Starlight), keep docs in the repo with PR review, build/preview/deploy in CI, version docs to match the product, and gate quality with link-checking + example-testing.
Scanned 9/23/2026
Skills Directorynpx -y skills add mcorbett51090/RavenClaude --skill docs-as-code-site --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Docs As Code Site?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/mcorbett51090-docs-as-code-site)More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.
---
name: docs-as-code-site
description: "Run docs like software: pick the tooling by needs (Docusaurus/Mintlify/MkDocs/Starlight), keep docs in the repo with PR review, build/preview/deploy in CI, version docs to match the product, and gate quality with link-checking + example-testing."
---
# Docs-as-Code Site
## Tooling by needs
Docusaurus/Starlight (flexible) / Mintlify (hosted, polished) / MkDocs (simple). Not the heaviest for a 20-page site.
## In the repo, in CI
Docs in the repo, reviewed in PRs, **build + preview** per PR, deploy on merge (with devops-cicd). A separate wiki rots.
## Gate quality
**Link-checking** + **example-testing** in CI fail the build on broken links/snippets.
## Versioning
Docs versioned to product versions; archive old, don't silently overwrite. Good **search/IA** beats more pages.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
