logoalt Hacker News

hungryhobbityesterday at 7:38 PM0 repliesview on HN

>Every bit of written documentation can and will be misinterpreted.

Yes, humans (and human languages) are flawed and lossy.

>A well-written ADR does not eliminate all ambiguity,

True: no docs can ever eliminate all ambiguity (on a decent sized project at least).

But this entire argument seems to be "letting perfect be the enemy of the good". Documentation doesn't have to be perfect or 100% unambiguous to be useful.