Archiboard

Set K · 5 sheets

Craft & Judgment

Decision records, how I draw, how I read documentation, and how to say no with a pen.

K-01 Craft & Judgment

Architecture decision records: a page per decision

One decision, one page, in the repository next to the code. In a multi-tenant web application every decision is inherited by every tenant, so the page matters more than it looks.

Drawn Sep 2011·Revised Mar 2025·6 min

K-03 Craft & Judgment

Reading Microsoft docs like an architect

The Architecture Center, the product docs and the Well-Architected Framework answer three different questions. Read the limits page first, check the date, and go to the samples repo when the words stop making sense.

Drawn Sep 2020·Revised Oct 2025·6 min

K-04 Craft & Judgment

Saying no to the feature that breaks the tenancy model

A report across sister companies, a user shared between tenants. Each sounds small, and each turns the tenant boundary into a suggestion. Say no with a drawing, and bring the alternative on the same sheet.

Drawn Jun 2024·Revised Feb 2026·6 min

K-05 Craft & Judgment

Fourteen years of .NET web applications: what changed, what did not

From ASP.NET MVC 2 and Entity Framework 4 to .NET 10. Hosting, configuration, resilience and telemetry became somebody else's problem. Tenancy, migrations, cost, saying no and naming things are still mine.

Drawn Oct 2024·Revised Aug 2026·7 min