Blog

A blog about documentation technologies, architectures, processes, and methodologies.

Deploying the website
Ships mast, sail and rigging by Annie Spratt, Unsplash licence, cropped

Deploying the website

Once I had some sample content in place, the next step was to deploy the site to Netlify. It is possible to set up continuous deployment, which means that Netlify monitors a designated Git repository for changes to a specified build (typically main) and automatically runs a build whenever changes are detected.

Continue reading
Customizing a Hugo theme
Palette by Zhang Xinxin, Unsplash licence, cropped

Customizing a Hugo theme

Although I liked the appearance of the Airspace theme, it was clear that I would need to make some changes to, minimally, specify the text and background colours, and to provide styling for AsciiDoc-related markup.

Continue reading
Creating a Hugo website
Seedlings by Julian Paolo Dayag, Unsplash licence, cropped

Creating a Hugo website

The basic setup of Hugo on your local computer is easy, and well documented: Go to the folder in which you want to create the Hugo site structure.

Continue reading
Website’s tech stack
Ship engine by Michal Mrozek, Unsplash licence, cropped

Website’s tech stack

This site is built using a Jamstack architecture. In March 2021 I hadn’t even heard of Jamstack, but then I began investigating current approaches to delivering online documentation, and suddenly Jamstack was everywhere.

Continue reading