Posts

Showing posts with the label docs as code

How to build a documentation portal with MkDocs and GitLab Pages

I wrote detailed documentation for the popular openvpn-install script — covering everything from quick start to script internals. Here's how I built the documentation portal using MkDocs Material, GitLab Pages, and CI/CD with pinned dependencies. The result is a fast, versioned, searchable documentation site with dark mode, code highlighting, Mermaid diagrams, and zero backend. Every push to main triggers an automatic build and deploy.