Best Practices

ADR: How the Heck Did We Get Here?

Code tells you what the system does. It almost never tells you why it was decided to be built that way. Architecture Decision Records are the simplest way I know to not lose that second part.