3 ms·

Maybe introduce lightweight architecture decision records in the design process? https://www.thoughtworks.com/radar/techniques/lightweight-architecture-decisio

Maybe introduce lightweight architecture decision records in the design process? https://www.thoughtworks.com/radar/techniques/lightweight-architecture-decision-records 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.

codetojoy 6y ago
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-architecture-decisions http://thinkrelevance.com/blog/2011/11/15/documenting-archit... [2] - https://www.youtube.com/watch?v=LMBqGPLvonU https://www.youtube.com/watch?v=LMBqGPLvonU