Week 35, Documentation matters

31 August 2025

Updated: 01 September 2025

Trying to get back into some regular blogging rhythym since if I don’t pay attention multiple months pass by between posts

What I’m working on

  • Wrote a bit about the impact Go has had on how I write software recently

  • Wrapped up work on Déjà vu which is a command line app to bring documentation to developers when they need it

  • Learning SwiftUI, basically watching pretty much everything Paul Hudson and Karin Prater have made

What I found

Mask

Something I spotted a while back and kind of just skimmed over, mask is a task runner (like make) that uses markdown for documenting commands. It seems great and is something I’d like to play around with in future

Gauge

On the topic of markdown, Gauge uses markdown docs to specify test specifications that are then backed by framework/language specific implementations to actually run those specs

Pages CMS

Pages CMS is a content management system I’ve been using for a while that provides a nice UI for working with markdown and JSON content and is actually what I’m writing this post on right now