logoalt Hacker News

evikstoday at 8:15 AM0 repliesview on HN

> they should be captured in your specifications / docs / ADRs, in a concise form that respects the reader's time.

And if'n they don't? What should the disrespected reader of the future do, not use the non-concise form?

> I guess everyone's just too cool to actually write good docs now?

They've always been cool like that, good docs have always been rare and precious