Hacker News Reader

Maybe introduce lightweight architecture decision records in the design process?

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.

View on HN

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

Reply on news.ycombinator.com