Category Archives

Docs-as-Code

Treating documentation like code: Git workflows, CI/CD pipelines, automated linting with Vale, and Static Site Generators.

Showing 3 published articles

Docs-as-Code 8 min read

Comparing Modern Static Site Generators for Docs: Docusaurus vs Starlight vs VitePress vs MkDocs Material

An architectural evaluation of the top four documentation static site generators: benchmark build times, Pagefind vs Algolia search, MDX component support, versioning, and decision matrix.

Nuhman Areekode

Sep 14, 2026

Docs-as-Code 8 min read

Automated Documentation Linting: Implementing Vale with Google and Microsoft Style Guides

How to automate editorial review using Vale: configuring .vale.ini, loading Google and Microsoft style packages, writing custom regex and AST rules, and integrating PR review...

Nuhman Areekode

Sep 08, 2026

Docs-as-Code 8 min read

Docs-as-Code Workflow Complete Guide: Git, Markdown, CI/CD, and Automated Testing

A comprehensive guide to implementing the Docs-as-Code methodology: Git branching strategies, Markdown formatting, automated link checking, Vale prose linting, and continuous deployment.

Nuhman Areekode

Sep 03, 2026