I instinctly want to agree. I remember quite a few examples of that.
On the other hand. This post can be weaponized as a argument towards: 'I did enough documentation. If you disagree you are unreasonable.'
Or from people that don't do documentation but spam. With that I mean people who do not think about what to put into the documentation, but throw in everything, mostly unsorted. Like: 'It is in there. On page 756, section C, subsection 1.3.3.4. Easy to find. Just look.'
In the end I think it all comes down to the question how reasonable people work together and with respect for each other.
> On the other hand. This post can be weaponized as a argument towards: 'I did enough documentation. If you disagree you are unreasonable.'
I don't think that's what she's advocating. Her point, as I am reading it (and her post aligns quite well with some of the worst experiences I have had), is that a reasonable person isn't going to come with "there's no docs" or even "there's not enough docs", they'll do a reasonable amount of searching find the docs, and instead approach with something concrete like, "Hey, I have $question about $system. I did see the docs here $link, but they don't seem to answer that." "Oh, yeah, not clearly enough. $answer" "Thanks! Do you mind if I send a PR to add that to the docs?" "Please, by all means!"
I feel like the whole 'docs' angle of this story is kind of a distraction. The bottom line (IMHO) is that reasonable coworkers, with a reasonable interest in coming to an amicable decision quickly, will not engage in this kind of behaviour.
The anti-social person can be the consumer of the docs, or the producer of the docs. In both cases they will find a way to pick a fight. The important thing is for the reasonable person to learn to recognize what is reasonable behaviour, and not fall into the trap of making protracted concessions in a futile attempt to be reasonable themself.
I think the point being made is that you will encounter unreasonable people at work over the course of your career, and this is an example of one particular type of unreasonable. The examples you mention are very real as well! At some point even if you act in good faith, there will be situations in which you absolutely cannot bridge the gap.
On the other hand. This post can be weaponized as a argument towards: 'I did enough documentation. If you disagree you are unreasonable.'
Or from people that don't do documentation but spam. With that I mean people who do not think about what to put into the documentation, but throw in everything, mostly unsorted. Like: 'It is in there. On page 756, section C, subsection 1.3.3.4. Easy to find. Just look.'
In the end I think it all comes down to the question how reasonable people work together and with respect for each other.