Why Writing Software Architecture Docs is So Painful and How to Solve it

If you start a conversation with an engineer by saying “We need to write the architecture documentation,” your best case is eye-rolling and deep sighs, and your worst case is they just turn and walk out of the room. That is how painful architecture ...