News for hackers. Stuff that matters.
Re:Ask HN: Is there a better way to document complex softwar... by jordache on Sunday November 25, 2018 @02:22PM (#18528416)
They are useful in articulating high-level insight on how systems integrate together.

A well done diagram would have an as of date, and some commentary along side boxes.

Re:Ask HN: Is there a better way to document complex softwar... by trading_wheels on Sunday November 25, 2018 @04:44PM (#18529253)
>> A well done diagram would have an as of date

maybe we should promote a "best before" date for technical artifacts...

Re:Ask HN: Is there a better way to document complex softwar... by jordache on Monday November 26, 2018 @12:00AM (#18531195)
How would author anticipate the freshness of that diagram? Not possible I say