[hungryhobbit]

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

[russnewcomer]

I agree. But that usefulness can be deceptive, especially when one thinks enough context has been captured to prevent misunderstandings. An LLM (or human, to be clear) can easily go down the wrong path from their own assumptions, and now you have three problems.

My main complaint is that articles like this lead people to think they they can avoid those three problems, without understanding why there are three.