RFR: Added section on maintainer-pain [v3]

[Jesper Wilhelmsson]

On Thu, 26 Nov 2020 22:49:30 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

>> I really don't think this entire section should be there. maintainer-pain is something that was discussed, and it made no sense, so it was discussed again and still seemed marginal and maybe was interesting to hotspot but has no broad acceptance or adoption.
>
>> I really don't think this entire section should be there. maintainer-pain is something that was discussed, and it made no sense, so it was discussed again and still seemed marginal and maybe was interesting to hotspot but has no broad acceptance or adoption.
> 
> Unless there is another mail thread about this that I've forgotten (or not seen) than the one I linked to above, I don't agree that the idea of having a label to indicate that an issue is urgent was deemed to make no sense. There was a misunderstanding in the early part of the thread due to initial bad naming of the label, but once people understood what the label was about I don't see anyone objecting to the use of such a label. There are several positive comments in that thread suggesting that such a label would make sense.
> 
> The label is only informational, there is no process that mandate that the label is used, but if someone set that label on your issue, you know what it means. It's up to you to decide wether to care or not, but as the text here says: "If you chose not to work on the issue, you should at least be aware that you are choosing to waste others' time and people will be affected by this choice."
> 
> As for adoption you are absolutely right. The label hasn't been used a lot and I guess that could either be a good sign - we don't have many such bugs - or a sign of no one knowing about the label.
> 
> After some mulling I do think I'd vote to include this section. I'd be willing to re-think the name of the label, "urgent" was suggested in the thread and in hind-sight I think it's a better label in some sense (more clear).

I moved the entire description to the JBS Label Dictionary instead. This makes it more clear that this is not really a process, but rather an explanation of how to interpret and use the label. I also removed some wording that made the text sound as a process.

@prrace Does this change make you more comfortable with the text?

-------------

PR: https://git.openjdk.java.net/guide/pull/37