News for hackers. Stuff that matters.
Re:Ask HN: I've been promoted to Architect. What do I need t... by tilolebo on Tuesday May 12, 2020 @09:42AM (#23153861)
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.

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