News for hackers. Stuff that matters.
Re:Ask HN: Is there a better way to document complex softwar... by pojzon on Sunday November 25, 2018 @06:47PM (#18529843)
"WORKING PRODUCT, over comprehensive documentation"

Software changes too fast to make a static snapshot of it. Its the same with comments in the code, few months later what was there is no longer valid and only creates confusion.

But i can understand managers dont like that because it makes it harder to replace ppl.

Re:Ask HN: Is there a better way to document complex softwar... by zeroname on Sunday November 25, 2018 @09:01PM (#18530466)
> Software changes too fast to make a static snapshot of it.

Architectures don't really change that fast or often, except maybe in the initial phase. That's why most UML diagrams are a waste, they are concerned with low-level details like classes or internal interfaces.

Re:Ask HN: Is there a better way to document complex softwar... by ako on Monday November 26, 2018 @01:15AM (#18531507)
Agreed, the architecture diagrams I usually look for are high level, mostly about how different systems are connected. These don't change that much.

When looking at architecture diagrams, usually you don't want them lower level details anyway, they would just obscure the big picture.