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