[tivert]

> The problem is that this sort of documentation is often incorrect, incomplete, or out of date, so people learn not to trust it.

That's not a problem with the documentation, it's a problem with those people's attitude.

I find "incorrect, incomplete, or out of date" documentation extremely valuable. Documentation is always just one data point in a constellation of data points needed to understand something, but it can often fill in important gaps that can't be filled in any other way. Not having it always leaves you off in a worse situation.