https://lab.artur-rios.tech/tags/docsy/Recent content in Docsy on Artur Rios LabHugoen-usWed, 21 Oct 2026 17:55:00 +0000https://lab.artur-rios.tech/infrastructure/infrastructure-documentation-sites/Wed, 21 Oct 2026 17:55:00 +0000https://lab.artur-rios.tech/infrastructure/infrastructure-documentation-sites/<p>Every project with users gets a documentation site: what it is, how to install and use it, and its reference. Heimdall&rsquo;s documentation is one, and so is the documentation of my .NET libraries. They are all built the same way.</p> <table> <thead> <tr> <th>Concern</th> <th>Choice</th> </tr> </thead> <tbody> <tr> <td>Generator</td> <td>Hugo, extended edition</td> </tr> <tr> <td>Theme</td> <td>Docsy, as a Hugo module</td> </tr> <tr> <td>Hosting</td> <td>GitHub Pages</td> </tr> <tr> <td>Deploys</td> <td>GitHub Actions</td> </tr> <tr> <td>DNS</td> <td>Cloudflare, optional</td> </tr> </tbody> </table> <h2 id="why-hugo">Why Hugo<a class="heading-anchor" href="#why-hugo" aria-label="Link to this section"></a></h2> <p>Hugo is a single binary that builds thousands of pages in about a second, and documentation is Markdown in a folder, next to the code it describes, reviewed in the same pull requests. Docsy is a documentation theme from Google with navigation, search and versioned sections built in.</p>