15

I just reviewed this proposed change for an improvement request I made:

Enter image description here

We were just trying to improve the quality of the example, but the result was someone being pissed off - how do we avoid such situations?

It's no problem to just reject this change, but still, what we achieved with this requests was a user turning his back to this topic, or maybe entirely to documentation. And if there are a few users like this, it's entirely possible that destructive proposals like this also get through the review.

7
  • 1
    This is a great question. I'm sure it doesn't feel good to spend time and effort creating a contribution only to have it flagged by multiple people, and we don't want to turn contributors away just because the first draft of their example wasn't perfect.
    – Kurtis Beavers Staff
    Commented Jul 23, 2016 at 12:33
  • and also I, as someone who flagged this, am not feeling to good about the result... Commented Jul 23, 2016 at 12:34
  • 2
    Yeah, I don't have a great solution in mind, but think this is worth understanding and exploring.
    – Kurtis Beavers Staff
    Commented Jul 23, 2016 at 12:35
  • 1
    As the overall quality of a lot of early (and many very poor) submissions gets improved, people will have a better understanding of expectations and won't be as offended by recommendations or feel targeted.
    – charlietfl
    Commented Jul 23, 2016 at 13:44
  • 4
    Don't feel bad for asking improvements. Without criticism there cannot be improvements. If someone does not want to participate because of being criticised it is his problem, not yours.
    – Dalija Prasnikar Mod
    Commented Jul 23, 2016 at 19:31
  • 3
    @DalijaPrasnikar: only up to a point. I suspect the rationale behind this Meta question is how feedback can be done that does not risk causing offence, which seems like an admirable thing to want to achieve.
    – halfer
    Commented Jul 24, 2016 at 13:35
  • @halfer yeah that's exactly what i wanted to know Commented Jul 24, 2016 at 15:01

1 Answer 1

14

We were just trying to improve the quality of the example, but the result was someone being pissed off - how do we avoid such situations?

We cannot cuddle everyone's little special snowflake feelings; it just doesn't scale. The critique in this case was accurate, and I don't feel that it was offensive. If the user couldn't take it, well, sadly we would have to make do without it.

7
  • 2
    Despite how blunt and potentially offensive your opening response is, I do believe you're correct. People tried to be helpful by offering information about how to improve the example. It's none of the voters' faults that the user felt discouraged, and it's the user's choice whether to contribute, or not. There's not a lot we can do when that happens.
    – user539810
    Commented Jul 23, 2016 at 22:19
  • 13
    All this could still be better handled using a normal comment system. There's a difference between being served an orange flag and 3 items of harsh criticism, and a discussion arising organically (which would also give the critiquee a chance to respond).
    – Pekka
    Commented Jul 24, 2016 at 13:16
  • @Pekka웃 the thing is that you can't comment on examples... SE gave us a very specific way to critique an example, via "improvement requests", we just need to adapt to them.
    – Braiam
    Commented Jul 24, 2016 at 13:30
  • 2
    @Braiam I don't think that's going to work. It's a totally stunted way of communicating.
    – Pekka
    Commented Jul 24, 2016 at 13:32
  • @Pekka웃 SE gave me lemons, I try to make quantum physics :P
    – Braiam
    Commented Jul 24, 2016 at 13:33
  • It's good this answer isn't addressed to the individual in question - talk about rubbing salt into the wound!
    – halfer
    Commented Jul 24, 2016 at 13:37
  • 2
    I agree with Pekka 웃 here. The whole improvement request scheme is fundamentally flawed by design. Instead of encouraging improvement by giving someone an opportunity to earn rep for performing the requested improvement, it punishes the person who created the original content, thus discouraging people from contributing to the docs at all. The way improvement requests affect rep needs to be fundamentally rethought and redesigned before this goes out of beta.
    – dgatwood
    Commented Jul 25, 2016 at 3:05

Not the answer you're looking for? Browse other questions tagged .