I agree that we don't have to please everybody, especially not everybody on Twitter (yikes!). However- this guy's reaction, strong interest in Nim and then outright disgust at the careless state of the docs closely mirrored my own, so it resonated strongly with me. I was almost that guy- I almost quit for exactly the same reason.
So while I agree that documenting things is an ongoing process and we don't have to be perfect- we sure as heck don't have to be appalling, either. I think right now we are, in terms of docs. An absolute piece of work of a dumpster fire of a trainwreck of a freak show. I'm not saying this to make ourselves feel bad, I just think those terms are very accurate descriptions, and we sure as heck need to get out of denial on the subject. But that can change! It's not _that_ hard, let's do it.
