News for hackers. Stuff that matters.
Re:The Guide to Software Architecture Documentation by specialist on Monday January 23, 2023 @11:00AM (#34490418)
In my experience, our internal documentation had two tangible benefits.

The team explaining to itself what they were working on. That process was the value. Consensus and alignment. Akin to forging culture. The artifacts generated were ephemeral. Basically performance art.

Managing upwards. PHBs want to see pretty pictures.

Re:The Guide to Software Architecture Documentation by andorov on Tuesday January 24, 2023 @04:06PM (#34510378)
Also changes to the diagram (at a certain resolution) require looping in specific senior people for review.