2 ms·
> 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'
by deathanatos 5y ago
> 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!"
- ghostpepper 5y agoI 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.