https://vanityurls.link/en/tags/adr/Recent content in Adr on vanityURLsHugoen-CAFri, 05 Jun 2026 11:50:57 -0400https://vanityurls.link/en/blog/architecture-decisions-in-the-code-repository/Tue, 26 May 2026 00:00:00 +0000https://vanityurls.link/en/blog/architecture-decisions-in-the-code-repository/<p>A setup page should tell an operator what to do.</p> <p>It should not carry the full history of why the Worker, installer, schema, release automation, and runtime security rules have their current shape. That history still matters. It belongs beside the implementation.</p> <p>vanityURLs keeps product-level decisions as architecture decision records in the code repository. The public docs stay operational. The code repo keeps the rationale that future maintainers will need when the next change looks obvious but is not.</p>