GitHub Pages on Artur Rios Lab

Documentation Sites

Wed, 21 Oct 2026 17:55:00 +0000

Every project with users gets a documentation site: what it is, how to install and use it, and its reference. Heimdall’s documentation is one, and so is the documentation of my .NET libraries. They are all built the same way.

Concern	Choice
Generator	Hugo, extended edition
Theme	Docsy, as a Hugo module
Hosting	GitHub Pages
Deploys	GitHub Actions
DNS	Cloudflare, optional

Why Hugo

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.

Static Sites

Wed, 21 Oct 2026 17:55:00 +0000

A static site is rendered to HTML, CSS and JavaScript when it is built, and served as files from then on: portfolios, brochure sites, event pages and small blogs. With no code running on a server, it can be hosted for free on a CDN and will never go down for want of a patch.

Concern	Choice
Generator	Astro for content-first sites, or Next.js with a static export
Styling	Tailwind CSS
Hosting	Cloudflare Pages, or GitHub Pages
Deploys	The host’s Git integration, or GitHub Actions

Its neighbours in this series draw the line: a page that needs a form or a server function is a landing page, on Vercel, and reference documentation is a documentation site, in Hugo.