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
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