News for hackers. Stuff that matters.
Re:Ask HN: Is there a better way to document complex softwar... by PopeDotNinja on Sunday November 25, 2018 @04:04PM (#18529022)
I tend to write up (not necessarily formal UML) diagrams in 2 cases:

1. I'm brainstorming with myself about how I want the software to behave

2. The software is basically done & tested, it's unlikely to change, and communicating the behavior to other people is of value, especially when describing a system that spans multiple components

Re:Ask HN: Is there a better way to document complex softwar... by trading_wheels on Sunday November 25, 2018 @04:40PM (#18529229)
I'll add (3) When I'm learning a new system, especially if it's big and/or old.

The idea is that if I go to the trouble to document it then the next person won't have to; this is seldom the case because as stated above the get out of date so fast. It's still a great way to learn and confirm your understanding though.

Re:Ask HN: Is there a better way to document complex softwar... by rorykoehler on Sunday November 25, 2018 @10:14PM (#18530774)
(4) Security audits