This Etiquette guide is co-opted from Rich Hickey's post to the Clojure mailing list some time ago.
The Adopt OpenJDK programme (and its mailing lists and IRC channel) are run by, and for, people who make things or contribute their time in other positive ways to the programme.
Most messages should have one of these themes:
- I'm adopting the OpenJDK - here is my contribution
- I am trying to adopt the OpenJDK and am having trouble, please help
- I can help you with that part of the OpenJDK
- I am trying to make something work for the OpenJDK and am having trouble, please help
- I can help you adopt the OpenJDK
They are not the place for opinion pieces and diatribes. They are not the place for massive legal and political debates, period.Occasionally, there may be disagreements about how a part of the OpenJDK has been, or will be, made. These disagreements should take the form of technical arguments. To make a technical argument that gets (and gives!) respect:
- Keep it short
- Stick to the facts
- Use logic
- Leave people out of it
- Avoid rhetorical devices:
- Superfluous or opinion-laden adjectives
- Claims to speak for the community, or that everyone agrees with you.
- Threats of what will happen unless things go your way
- Any flavor of 'the sky is falling'
If you are not working on that piece of the OpenJDK, you should restrict your input to very short technical arguments supporting your position. If someone has already made your point, just +1 it.
Please keep your posts short.
Ignoring these guidelines fails to respect the time and effort of people who are trying to make a positive difference, which you should care about if you intend to be one.