Proposal: A Code of Conduct for the Go community
Author: Andrew Gerrand email@example.com
Last updated: 17 November 2015
This proposal specifies a Code of Conduct for the Go community. The code is to be enforced in all project-operated spaces (specified in the Code of Conduct text, below). Other Go-related spaces (forums, events, etc) are encouraged to adopt the code as well.
Since Go’s release over 6 years ago, a sizable community has grown around the language. The golang-nuts mailing list has more than 17k members and receives thousands of posts each month, and there are many major Go conferences each year with thousands of attendees.
Today the various Go spaces are moderated by people that are unknown to the public and with no specified policy. It is not clear to the members of these spaces how they are expected to conduct themselves. In the rare cases where people are banned, they are afforded no recourse.
For a community of this scale to grow and prosper, it needs guidelines to encourage productive and positive participation, and a process for resolving conflict when it inevitably arises.
The community must also grow to survive. An explicit goal of this proposal is to promote cultural diversity within our community and thereby make it more welcoming and inclusive.
A Code of Conduct document is added to the “go” repository as
doc/conduct.html, visible on the web at https://golang.org/conduct.
The document is linked prominently from official Go spaces (such as the
golang-nuts mailing list).
The document text is as follows.
About the Code of Conduct
Why have a Code of Conduct?
Online communities include people from many different backgrounds. The Go contributors are committed to providing a friendly, safe and welcoming environment for all, regardless of age, disability, gender, nationality, race, religion, sexuality, or similar personal characteristic.
The first goal of the Code of Conduct is to specify a baseline standard of behavior so that people with different social values and communication styles can talk about Go effectively, productively, and respectfully.
The second goal is to provide a mechanism for resolving conflicts in the community when they arise.
The third goal of the Code of Conduct is to make our community welcoming to people from different backgrounds. Diversity is critical to the project; for Go to be successful, it needs contributors and users from all backgrounds. (See Go, Open Source, Community.)
With that said, a healthy community must allow for disagreement and debate. The Code of Conduct is not a mechanism for people to silence others with whom they disagree.
Where does the Code of Conduct apply?
If you participate in or contribute to the Go ecosystem in any way, you are encouraged to follow the Code of Conduct while doing so.
Explicit enforcement of the Code of Conduct applies to the official forums operated by the Go project (“Go spaces”):
- The official GitHub projects and code reviews.
- The golang-nuts and golang-dev mailing lists.
- The #go-nuts IRC channel on Freenode.
- The /r/golang subreddit.
Other Go groups (such as conferences, meetups, and other unofficial forums) are encouraged to adopt this Code of Conduct. Those groups must provide their own moderators and/or working group (see below).
These are the values to which people in the Go community (“Gophers”) should aspire.
- Be friendly and welcoming
- Be patient
- Remember that people have varying communication styles and that not everyone is using their native language. (Meaning and tone can be lost in translation.)
- Be thoughtful
- Productive communication requires effort. Think about how your words will be interpreted.
- Remember that sometimes it is best to refrain entirely from commenting.
- Be respectful
- In particular, respect differences of opinion.
- Be charitable
- Interpret the arguments of others in good faith, do not seek to disagree.
- When we do disagree, try to understand why.
- Avoid destructive behavior:
- Derailing: stay on topic; if you want to talk about something else, start a new conversation.
- Unconstructive criticism: don't merely decry the current state of affairs; offer—or at least solicit—suggestions as to how things may be improved.
- Snarking (pithy, unproductive, sniping comments)
- Discussing potentially offensive or sensitive issues; this all too often leads to unnecessary conflict.
- Microaggressions: brief and commonplace verbal, behavioral and environmental indignities that communicate hostile, derogatory or negative slights and insults to a person or group.
People are complicated. You should expect to be misunderstood and to misunderstand others; when this inevitably occurs, resist the urge to be defensive or assign blame. Try not to take offense where no offense was intended. Give people the benefit of the doubt. Even if the intent was to provoke, do not rise to it. It is the responsibility of all parties to de-escalate conflict when it arises.
These actions are explicitly forbidden in Go spaces:
- Insulting, demeaning, hateful, or threatening remarks.
- Discrimination based on age, disability, gender, nationality, race, religion, sexuality, or similar personal characteristic.
- Bullying or systematic harassment.
- Unwelcome sexual advances.
- Incitement to any of these.
The Go spaces are not free speech venues; they are for discussion about Go. These spaces have moderators. The goal of the moderators is to facilitate civil discussion about Go.
When using the official Go spaces you should act in the spirit of the “Gopher values”. If you conduct yourself in a way that is explicitly forbidden by the CoC, you will be warned and asked to stop. If you do not stop, you will be removed from our community spaces temporarily. Repeated, wilful breaches of the CoC will result in a permanent ban.
Moderators are held to a higher standard than other community members. If a moderator creates an inappropriate situation, they should expect less leeway than others, and should expect to be removed from their position if they cannot adhere to the CoC.
Complaints about moderator actions must be handled using the reporting process below.
The Code of Conduct Working Group is a group of people that represent the Go community. They are responsible for handling conduct-related issues. Their purpose is to de-escalate conflicts and try to resolve issues to the satisfaction of all parties. They are:
- Aditya Mukerjee firstname.lastname@example.org
- Andrew Gerrand email@example.com
- Dave Cheney firstname.lastname@example.org
- Jason Buberel email@example.com
- Peggy Li firstname.lastname@example.org
- Sarah Adams email@example.com
- Steve Francia firstname.lastname@example.org
- Verónica López email@example.com
If you encounter a conduct-related issue, you should report it to the Working Group using the process described below. Do not post about the issue publicly or try to rally sentiment against a particular individual or group.
- Mail firstname.lastname@example.org or
submit an anonymous report.
- Your message will reach the Working Group.
- Reports are confidential within the Working Group.
- Should you choose to remain anonymous then the Working Group cannot notify you of the outcome of your report.
- You may contact a member of the group directly if you do not feel comfortable contacting the group as a whole. That member will then raise the issue with the Working Group as a whole, preserving the privacy of the reporter (if desired).
- If your report concerns a member of the Working Group they will be recused from Working Group discussions of the report.
- The Working Group will strive to handle reports with discretion and sensitivity, to protect the privacy of the involved parties, and to avoid conflicts of interest.
- You should receive a response within 48 hours (likely sooner). (Should you choose to contact a single Working Group member, it may take longer to receive a response.)
- The Working Group will meet to review the incident and determine what happened.
- With the permission of person reporting the incident, the Working Group may reach out to other community members for more context.
- The Working Group will reach a decision as to how to act. These may include:
- A request for a private or public apology.
- A private or public warning.
- An imposed vacation (for instance, asking someone to abstain for a week from a mailing list or IRC).
- A permanent or temporary ban from some or all Go spaces.
- The Working Group will reach out to the original reporter to let them know the decision.
- Appeals to the decision may be made to the Working Group, or to any of its members directly.
Note that the goal of the Code of Conduct and the Working Group is to resolve conflicts in the most harmonious way possible. We hope that in most cases issues may be resolved through polite discussion and mutual agreement. Bannings and other forceful measures are to be employed only as a last resort.
Changes to the Code of Conduct (including to the members of the Working Group) should be proposed using the change proposal process.
- Treat everyone with respect and kindness.
- Be thoughtful in how you communicate.
- Don’t be destructive or inflammatory.
- If you encounter an issue, please mail email@example.com.
Parts of this document were derived from the Code of Conduct documents of the Django, FreeBSD, and Rust projects.
Do we need a Code of Conduct? Some community members have argued that people should be trusted to do the right thing, or simply ignored when they do not. To address the former: there are varying definitions of the “right thing”; a Code of Conduct specifies what that means. To address the latter: if we allow destructive forms of communication (those that go against the "Gopher Values") to flourish, we will be left only with people who enjoy that kind of communication.
The CoC also makes moderation processes more transparent: the various Go spaces have always been moderated spaces, but the rules were never written down. It seems better to be explicit about the behavior we expect in those spaces.
Why write our own? There are many existing Codes of Conduct to choose from, so we could have saved some time by simply re-using an existing one. This document does draw heavily on existing documents such as the Rust, FreeBSD, and Django Codes of Conduct, but it includes some original material too. I opted for this approach to specifically address the needs of the Go community as I understand them.
Is behavior outside Go spaces covered by this CoC? An earlier draft of this proposal included a clause that behavior outside Go spaces may affect one’s ability to participate within them. After much community feedback, I removed the clause. It was seen as unnecessarily overreaching and as providing an opportunity for malicious people to oust community members for their behavior unrelated to Go.
The “Gopher Values” are not my values. I consider myself part of the Go community; shouldn’t the CoC represent me, too? Members of the Go community are from many different cultures; it would be impossible to represent the full range of social norms in a single document. Instead, the values described by the CoC are designed to reflect the lowest common denominator of behavior necessary for civil discourse. Community members (including the author of this document) whose norms may be regarded by others as impolite or aggressive are expected to be self-aware and thoughtful in how they communicate to avoid creating conflict.
The Code of Conduct document seems unnecessarily long. Can’t it just be a version of the Golden Rule? The Go community comprises thousands of people from all over the world; it seems unrealistic to assume that those individuals should have compatible ideas about how to get along with each other. By describing the kind of behavior to which one should aspire, and those behaviors that are explicitly forbidden, we at least give all community members an idea of what is expected of them.
Note that this document is a proposal document; the Code of Conduct itself is a subset of the proposal document and is about 1,200 words long, including the description of the reporting process. The “Gopher Values” section—the meat of the thing—is under 300 words.
Examples of CoC issues and their resolutions
These fictional examples show how community members and the working group might use the Code of Conduct’s guidelines to resolve a variety of issues. In each case, the goal of the intervention is to raise the level of discourse and to make people feel welcome in our community spaces.
Rude and unwelcoming behavior:
- B and C are posting back and forth on a golang-nuts thread.
- D enters the conversation and proposes an alternative solution.
- B and C ignore D and continue their discussion.
- D re-articulates their point in a different way.
- B responds to D by asking them to "butt out".
- C emails B privately, noting that B's reaction was uncalled-for, and suggests that B apologize to D.
- B replies that they have nothing to apologize for.
- C reports the incident to the CoC Working Group.
- E, a member of the working group, contacts B and C separately to get details on the incident.
- E asks B to apologize for being unwelcoming and rude, and notifies C that this action was taken.
- B acknowledges their mistake and apologizes to D.
- The issue is resolved.
In this case, B could have avoided conflict by just saying nothing, or by responding politely to D’s messages. It’s not OK to be rude or exclusive in the public forum. (If B and C want to discuss things privately, they should take it off-list.)
A classic troll:
- B repeatedly posts about a particular issue, raising the issue on unrelated threads, as well as starting many redundant threads.
- The forum moderators warn B to stop, as derailing threads and spamming are against the CoC.
- B refuses and becomes belligerent, making insulting remarks about the moderators and other members of the community.
- The moderators ban B from the forum for 10 days, and post a message explaining this.
- The issue is resolved.
In this case, the goal is for the user to come back after a while and hopefully be more productive in the future. We don’t want to ban them forever; it is important to keep people with unpopular opinions around to prevent the community from becoming an echo chamber.
- B posts a message to /r/golang describing the approach they're planning to take for wrapping http.HandlerFunc and asking for feedback.
- C replies to the message "Why don’t you just do it the obvious way?" with an explanation of an alternate approach.
- D, a bystander to this exchange, replies “That may have been obvious to you, but you shouldn’t assume that it’s obvious to just anyone.”
- C replies “Well I guess you’re an idiot too, then.”
- E, a moderator, observes this interaction and sends a message to C to tell them their behavior is unacceptable.
- C insists there is nothing wrong with their behavior.
- E replies publicly to C on the original thread to say “Condescension and personal insults are not appropriate in this forum. Please observe the Code of Conduct when posting here.”
- The issue is resolved.
- B has a typically female name and posts to a mailing list to announce a Go-to-Forth compiler they wrote.
- C replies “I am amazed to see a woman doing such great work. Nice job!”
- B writes to the CoC Working Group to say “I felt really deflated for my work to be seen as impressive just because I’m a woman. Can you say something to C for me?”
- D, a member of the working group, reaches out to C to explain how comments like that can make women feel out of place in technical communities.
- Recognizing the hurt C has caused, C sends an email to B to apologise.
- The issue is resolved.
In this case, we see the a working group member acting as a mediator for someone who didn’t feel comfortable confronting someone directly. The working group member D contacted C in private to discuss the issue, to avoid bringing shame to C in public, since C apparently meant no harm.
- B asks a seemingly simple question on the mailing list.
- C replies back with an answer and an additional comment to "RTFM before you ask simple questions!!!"
- B points out the small detail C overlooked in the question to clarify the complexity.
- C replies back "Ack! Sorry, I actually don't know."
- E enters the conversation and criticizes C for his behavior in his original reply, raising the issue further with a moderator.
- D, a moderator, replies to the list to ask C to be less impatient in their responses, suggesting they could have instead said something like "The docs cover this."
- The issue is resolved.
In this case, the moderators acted in a purely advisory role.
An abrasive newcomer, a pithy response:
- B makes their first post to golang-nuts: "What's the deal with Go's error handling mechanism? It's brain dead and stupid."
- C, a forum regular, replies “Oh no, not another one.”
- D, another regular replies (compensating for C) “Hi, welcome to the list. As I’m sure you can appreciate, this topic has come up many times before. Here are some links to previous discussions and articles that discuss the topic. Let us know if you have any questions that aren’t covered by those threads. Thanks.”
- E, a moderator, reaches out to C off list to ask them to refrain from this kind of pithy, unhelpful commentary in the future.
- There is no need for further action.
In this case, we see a community member (D) try to steer the discussion in a productive direction, while a moderator tries to prevent future negativity without creating a public drama.
Some people feel stifled by the general concept of a Code of Conduct. Others may find explicit efforts to improve diversity in our community unpalatable for various reasons. While a major goal of this proposal is to make the community more inclusive, this does by definition exclude people that cannot abide by the goals and principles of the code. I see this as a regrettable but necessary and inescapable design tradeoff. The implementation of the code may cause us to lose a few people, but we stand to gain much more.
I (Andrew Gerrand) will submit the Code of Conduct text to the main Go repository, so that it is available at the URL https://golang.org/conduct. I will also set up the firstname.lastname@example.org email address and the anonymous web form.
Then I will link the document prominently from these places:
CONTRIBUTING.mdfiles in the official Go repositories.
- The golang-nuts and golang-dev mailing list welcome messages.
- The #go-nuts IRC channel topic.
- The /r/golang subreddit sidebar.
I will work with the existing moderators of these spaces to implement the Code of Conduct in those spaces, recruiting additional moderators where necessary.
Operators of unofficial Go events and forums are encouraged to adopt this Code of Conduct, so that our community members can enjoy a consistent experience across venues.
- The Working Group does not yet include anyone from Asia, Europe, or Africa. In particular, Europe and China are home to a large swath of Go users, so it would be valuable to include some people from those areas in the working group. (We have some volunteers from Europe already.)
- The proposed process does not "scale down" to projects of a single maintainer. Future revisions should permit a lightweight version of the process, but that is considered outside the scope of this document.