Re:Ask HN: I've been promoted to Architect. What do I need t...
by codetojoy on Saturday May 16, 2020 @02:19PM
(#23205834)
I second the motion for ADRs (resources below). A side-benefit is that they use Markdown: plain and simple. Try to use Markdown (or similar) as much as possible. Once you are used to it, it is hard to go back to the insane formatting friction in a word processor.
[1] - http://thinkrelevance.com/blog/2011/11/15/documenting-archit... [2] - https://www.youtube.com/watch?v=LMBqGPLvonU
https://www.thoughtworks.com/radar/techniques/lightweight-ar...
I think it's a nice way of sharing with other engineers why and when decisions have been made about the use of a technique or technology.