Most teams either skip documenting architecture decisions entirely or create heavyweight documents everyone ignores. ADRs fix this - but only when they’re lightweight enough to write during the decision, structured enough to answer ‘why did we do that?’ six months later, and stored where people actually look. Here’s a practical approach with a template that sticks.

Software development has more in common with scientific research than engineering. Using the Cynefin framework, this post looks at why building a bridge is a complicated problem, why building software is a complex one, and why that difference explains Waterfall’s failures and Agile’s fit.

A brief summary of Allen Holub’s “Getting Buy-In: Overcoming Larman’s Law” at the YOW! Brisbane conference December 2024.

Some notes on deploying AnythingLLM in an Azure Container Instance using Bicep, ensuring persistent storage. AnythingLLM allows you to use multiple LLMs, using your existing API keys, with one UI.

Learn how to deploy an Azure Container Instance (ACI) container group with HTTPS enabled using Caddy. This guide walks through deploying a Hello World app and securing it with SSL using a Bicep template.