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.

A look at why software development isn’t engineering - it’s a scientific journey through complexity. Explore how the Cynefin framework exposes why Agile thrives where Waterfall fails, why requirements shift like ecosystems, and why adaptability beats rigid blueprints. Learn why software isn’t built - it’s discovered.

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.