-
-
Notifications
You must be signed in to change notification settings - Fork 3
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Moderation Policy #6
base: main
Are you sure you want to change the base?
Changes from all commits
ef5596e
c0e7833
dd8e7ae
2b73663
a1ee0aa
20da36d
a24187c
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,243 @@ | ||
# Moderation policy | ||
|
||
If you are not a member and wish to submit a moderation request, please see [Requesting Moderation][]. | ||
|
||
## Table of Contents | ||
|
||
- [Applicability][] | ||
- [Terms][] | ||
- [Grounds for Moderation][] | ||
- [Requesting Moderation][] | ||
- [Consideration of Intent][] | ||
- [Guidelines and Requirements][] | ||
- [Collaborator Posts][] | ||
- [Non-Collaborator Posts][] | ||
- [Temporary Interaction Limits][] | ||
- [Temporary and Indefinite Blocks][] | ||
- [Privacy of the expressjs/moderation Repository][] | ||
- [Moderation Team][] | ||
- [Escalation of Issues][] | ||
- [Modifications to This Policy][] | ||
|
||
## Applicability | ||
|
||
This policy applies to all repositories under these GitHub organizations: expressjs, jshttp, and pillarjs, Working Groups, Slack, Discord, and any other official communication channels. | ||
|
||
Additionally, if your personal presence (e.g., social media profiles) mentions involvement in the project (e.g., "Express.js contributor" in your Twitter bio), the policy extends to your posts. This applies to all members of the Express.js, jshttp, and pillarjs GitHub organizations, including Collaborators, TC members, and the Moderation Team. | ||
|
||
Any posts, comments, issues, or pull requests that violate the [Code of Conduct][] are subject to Moderation as defined in this policy. | ||
|
||
## Terms | ||
|
||
- _Collaborator_ refers to any individual with configured triage role or higher in any expressjs GitHub organization repository. See [GitHub's Repository roles documentation][] for more information. | ||
- _TC_ refers to the [expressjs Technical Committee][]. | ||
- _Post_ refers to the content and titles of any issue, pull request, comment, discussion, or wiki page. | ||
- _Moderate_ means to modify, lock, or delete one or more Posts to correct or address Code of Conduct violations. | ||
- _Remove_ refers to the act of removing the configured write (commit) permissions for an individual Collaborator's GitHub account from _all_ expressjs, jshttp, and pillarjs repositories as well as removing the account from the expressjs, jshttp, and pillarjs organizations membership. | ||
- _Block_ refers to the act of prohibiting an individual GitHub account from any further participation in the expressjs, jshttp, and pillarjs organizations. A block may be _temporary_ or _indefinite_. | ||
- This Moderation Policy applies only to blocking from the organization. Individuals may choose to [block other individuals from their personal GitHub accounts][]. This policy does not restrict blocking from personal GitHub accounts. | ||
- _Requester_ refers to an individual requesting Moderation on a Post. | ||
|
||
## Grounds for Moderation | ||
|
||
Any Post in violation of the expressjs [Code of Conduct][] is subject to Moderation. | ||
|
||
The Moderation Team is responsible for deciding what constitutes inappropriate behavior that may be subject to Moderation. | ||
|
||
## Requesting Moderation | ||
|
||
Anyone may request Moderation of a Post. Requesting Moderation of a Post can be accomplished in one of four ways: | ||
|
||
- Via the [report@expressjs.com][] email address, | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. IMO We will need to wait until we have that email alias ready before landing this PR. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Sure. That brings the question, will everyone at Moderation team have access to that mailbox? What is the plan regarding that? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We need to work with the CPC on this. We have some emails setup, but I think we need to do some administrative work before we can use them. |
||
- Via private email to individual [Moderation Team members][], | ||
- Via a new Post in the same thread as the Post being requested for Moderation, | ||
- Via a new Post in the private expressjs/moderation repository. | ||
|
||
Note that Collaborators may Moderate non-Collaborator Posts at any time without submitting an initial request (see: [Non-Collaborator Posts][]). | ||
|
||
Use of the [report@expressjs.com][] email address -- or private email to individual Moderation Team members -- is appropriate when the individual requesting the Moderation does not feel comfortable directly or publicly making the request. All emails sent to the [report@expressjs.com][] address are currently forwarded to all members of the Moderation Team. | ||
|
||
When a request is sent by email to the [report@expressjs.com][] (or directly to a Moderation Team member) the moderation team must log the issue internally and report it periodically to the TC. | ||
|
||
Requests should contain as much information and context as possible, including the URL and a screenshot of the Post in question. Screenshots may be modified to obscure obscene or offensive content. | ||
|
||
External public venues or social media services such as Twitter must never be used to request Moderation. | ||
|
||
Collaborators must never discuss the specific details of a Moderation request in any public forum or any social media service outside of the expressjs GitHub Organizations. | ||
|
||
Note that quoting the original content of a Post within a Moderation request or expressjs/moderation repository issue is not a violation of the [Code of Conduct][]. However, discretion is advised when including such quotes in requests posted to public repositories. | ||
|
||
Requests for Moderation that do not appear to have been submitted in good faith with intent to address a legitimate [Code of Conduct][] violation will be ignored. | ||
|
||
## Consideration of Intent | ||
|
||
Before Moderating a Post, Collaborators should carefully consider the possible intent of the author. It may be that the author has simply made an error or is not yet familiar with the [Code of Conduct][]; or it may be that cultural differences exist, or that the author is unaware that certain content is inappropriate. In such cases, the author should be given an opportunity to correct any error that may have been made. | ||
|
||
Note, however, that unfamiliarity with the [Code of Conduct][] does not excuse a Post from Moderation. | ||
|
||
## Guidelines and Requirements | ||
|
||
- All Posts are expected to respect the expressjs [Code of Conduct][]. | ||
- Any Collaborator with triage permission to a given repository (except expressjs/moderation) may Moderate Posts within that repository's issue tracker. Only the Moderation team is allowed to moderate posts on expressjs/moderation. | ||
- The Moderation Team serves as the final arbiter for all Moderation issues. | ||
- Moderation Team members may Remove or Block an individual from the expressjs GitHub Organizations. | ||
- For any Removal or Blocking action, an issue describing the reasons for the action, and identifying the Github account being acted upon, must be posted to the Moderation Repository with an explanation provided by the Moderation Team member performing the action. | ||
- Any individual Blocked from the expressjs, jshttp, and pillarjs organizations will be recommended for exclusion from any OpenJS Foundation sponsored event or activity. | ||
- Minor edits to the formatting of a Post or to correct typographical errors are not "Moderation". Such edits and their intent must still be documented with a short note indicating the reason. | ||
|
||
### Collaborator Posts | ||
|
||
- Prior to Moderating any Post authored by a Collaborator, the author must be given a reasonable opportunity to modify or remove the Post on their own. | ||
- If the author of the Post disagrees that Moderation is required, the matter can be escalated to the Moderation Team for resolution. In such cases, no Moderation action may be taken until a decision by the Moderation Team is made. | ||
- When Moderating any Post authored by another Collaborator, the moderating Collaborator must: | ||
- Explain the justification for Moderating the post, | ||
- Identify all changes made to the Post, and | ||
- Identify the steps previously taken to resolve the issue. | ||
- If the Moderation action included Blocking, an indication of whether the Block is temporary or indefinite is required, along with an issue posted to the moderation repository justifying the action. | ||
- Explanations of Moderation actions on Collaborator Posts must be provided in: | ||
- A new post within the original thread, or | ||
- A new issue within the private expressjs/moderation repository. | ||
- Any Collaborator habitually violating the Code of Conduct or this Moderation policy may be Blocked temporarily or, in extreme cases, Removed and Blocked indefinitely. | ||
|
||
### Non-Collaborator Posts | ||
|
||
- Posts authored by non-Collaborators are always subject to immediate Moderation by any Collaborator if the content is intentionally disruptive or in violation of the [Code of Conduct][]. | ||
- When moderating non-Collaborator posts, the moderating Collaborator must: | ||
- Explain the justification for Moderating the post, and | ||
- Identify all changes made to the Post. | ||
- If the Moderation action included Blocking, an indication of whether the Block is temporary or indefinite is required, along with a note justifying the action. | ||
- If an explanation of a Moderation action for a non-Collaborator Post is provided, it must be provided in: | ||
- The original Post being modified (as replacement or appended content), | ||
- A new post within the original thread, or | ||
- A new issue within the private expressjs/moderation repository. | ||
- Moderation of Posts authored by non-Collaborators may result in those non-Collaborators being Blocked temporarily or indefinitely from further participation in the expressjs GitHub organization. | ||
- If it is clear that there is no intention to collaborate in good faith, it is possible to hide comments of non-Collaborators. In that case there is an exception to the reporting requirement described above. | ||
- Accounts that are reasonably believed to be bots (other than bots authorized by the TC) are subject to immediate Blocking. | ||
- Issues, pull requests, discussions, and comments that are spam (job posting, service advertising, etc.) are subject to immediate moderation. | ||
- Collaborators may use the Hide feature in the GitHub interface for off-topic posts by non-Collaborators. | ||
- Moderation Team members and TC voting members can delete any issues or comments posted by accounts that have been deleted by GitHub. These accounts show up in the GitHub interface as user `ghost`. There is no need to screenshot or document these deletions. | ||
|
||
There are a few examples of moderating non-Collaborator posts: | ||
|
||
Scenario 1: | ||
|
||
- A non-Collaborator posts a comment that indicates that they are a bot. | ||
- A collaborator sees the post and hides it. | ||
- No further action is necessary. | ||
|
||
Scenario 2: | ||
|
||
- A non-Collaborator posts a comment that is against the Code of Conduct. | ||
- A Collaborator sees the comment and asks the author to edit it. | ||
- The author refuses to edit their comment. | ||
- The Collaborator deletes the comment and posts an issue in the moderation repository explaining their actions. | ||
|
||
Scenario 3: | ||
|
||
- A non-Collaborator opens a pull request with comments indicating they are a bot. | ||
- A Collaborator sees that pull requests, closes it, deletes the comments and posts an issue in the moderation repository explaining their actions. | ||
- A moderation team member sees the issue and decides to block the user from the organization. | ||
|
||
Scenario 4: | ||
|
||
- A non-Collaborator posts a comment on an old commit that is against the Code of Conduct. | ||
- A Collaborator sees the comment, takes a screenshot, and deletes it. | ||
- The Collaborator posts an issue in the moderation repository explaining their actions. | ||
|
||
### Temporary Interaction Limits | ||
|
||
The Moderation Team may, at their discretion, choose to enable [GitHub's Temporary Interaction Limits][] on any GitHub repository in the expressjs, jshttp, and pillarjs GitHub Organizations. | ||
|
||
Any Collaborator may request that the Moderation Team enable the Temporary Interaction Limits by posting an issue to the moderation repository. If the Moderation Team chooses not to do so, then a comment explaining why that decision was made must be added to the moderation repository thread. | ||
|
||
### Temporary and Indefinite Blocks | ||
|
||
A Temporary Block is time limited, with the timeframe decided on by the Moderation Team at the time of issuing, depending on the severity of the issue. Recommended default options are 24-hour, 48-hour, and 7-day periods. | ||
|
||
An Indefinite Block is set for an unspecified period of time and may only be lifted for an individual through a simple majority vote of the Moderation Team. | ||
|
||
## Privacy of the expressjs/moderation Repository | ||
|
||
The expressjs/moderation Repository is used to discuss the potentially sensitive details of any specific moderation issue. The repository is private but accessible to all Collaborators. The details of any issue discussed within the expressjs/moderation repository are expected to remain confidential and are not to be discussed in any public forum or social media service. | ||
|
||
Any Collaborator found to be violating the privacy of the expressjs/moderation repository by repeatedly sharing or discussing the details of expressjs/moderation issues in any public forum or social media service risks being permanently removed from the expressjs GitHub organization. | ||
|
||
## Moderation Team | ||
|
||
The expressjs Moderation Team is tasked with enforcement of this policy. | ||
|
||
At least once per month, the Moderation Team must provide a report of all Moderation actions taken by the Moderation Team to the TC. | ||
|
||
_Requirements_ | ||
|
||
- Must be a Collaborator in the expressjs GitHub organization. | ||
- Active participation in the expressjs/moderation repository. | ||
- Show a commitment to the expressjs [Code of Conduct][]. | ||
|
||
_Nomination_ | ||
|
||
Moderation team members are Collaborators who self-nominate or are nominated by the TC. Team members must be approved by the TC with annual recertification. If there are no objections after seven days, the nomination is automatically accepted. If there are objections to a specific nomination, then a TC vote in favor of the nomination is required. | ||
|
||
_Onboarding_ | ||
|
||
New Moderation Team members are onboarded with: | ||
|
||
- an invite to expressjs Moderation Team channel in the OpenJS Slack | ||
- permission changes made to GitHub to allow access to moderate | ||
- a walkthrough of relevant processes, expectations, and documents by an existing Moderation Team member | ||
- access to existing documents | ||
|
||
_Recertification_ | ||
|
||
An annual recertification vote is required for all Moderation Team members. For an individual to be recertified, a TC vote in favor of recertification is required. | ||
|
||
_Departure_ | ||
|
||
A TC vote is required to remove a moderator who has not resigned. | ||
|
||
_Resignation_ | ||
|
||
At any time a Moderation Team member may notify the team that they will no longer be serving. Either the resigning member or an active member will file an issue notifying the Admin group that the team member is stepping down. An active team member will take necessary steps to remove resigning team member from respective permissions and private access. | ||
|
||
<!-- referenced from the CoC page --> | ||
|
||
<a id="current-members"></a> | ||
|
||
### Current Members of Moderation Team | ||
|
||
|
||
|
||
## Escalation of Issues | ||
|
||
Moderation issue disputes not involving a TC voting member or Moderation Team member may be escalated to the TC for review by tagging the original issue, pull request, or associated expressjs/moderation repository tracking issue with the `moderation-review` label. Any such Moderation action may be overturned through a TC vote. | ||
|
||
TC or Moderation Team members directly involved in a Moderation issue (as either the Requester or author of the Post in question) are required to recuse themselves from any decisions required to resolve the | ||
issue. | ||
|
||
Moderation disputes involving TC or Moderation Team members, including questions of whether a TC or Moderation Team member has violated the Code of Conduct, _shall_ be referred to an Independent Mediator selected by the OpenJS Foundation. | ||
|
||
## Modifications to This Policy | ||
|
||
Modifications to this policy are subject to approval by the TC. When modifications are proposed, if there are no objections after 72 hours, the modifications are accepted. If there any objections to any proposed change, a TC vote in favor of the change is required. | ||
|
||
[Code of Conduct]: https://github.com/expressjs/express/blob/master/Code-Of-Conduct.md | ||
[expressjs Technical Committee]: https://github.com/expressjs/express/blob/master/Readme.md#tc-technical-committee | ||
[GitHub's Repository roles documentation]: https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#repository-roles-for-organizations | ||
[GitHub's Temporary Interaction Limits]: https://github.com/blog/2370-introducing-temporary-interaction-limits | ||
[Applicability]: #applicability | ||
[Terms]: #terms | ||
[Grounds for Moderation]: #grounds-for-moderation | ||
[Requesting Moderation]: #requesting-moderation | ||
[Consideration of Intent]: #consideration-of-intent | ||
[Guidelines and Requirements]: #guidelines-and-requirements | ||
[Collaborator Posts]: #collaborator-posts | ||
[Non-Collaborator Posts]: #non-collaborator-posts | ||
[Temporary Interaction Limits]: #temporary-interaction-limits | ||
[Temporary and Indefinite Blocks]: #temporary-and-indefinite-blocks | ||
[Privacy of the expressjs/moderation Repository]: #privacy-of-the-expressjsmoderation-repository | ||
[Moderation Team]: #moderation-team | ||
[Moderation Team members]: #current-members | ||
[Escalation of Issues]: #escalation-of-issues | ||
[Modifications to This Policy]: #modifications-to-this-policy | ||
[report@expressjs.com]: mailto:report@expressjs.com | ||
[block other individuals from their personal GitHub accounts]: https://help.github.com/en/articles/blocking-a-user-from-your-personal-account |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This policy also needs to apply to any project run comms: slack, discord, socials (the ones on behalf of the project, not personal), etc. Not just githbu.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Typically, if one's personal presence anywhere also mentions that you're involved in the project, that makes it an applicable space. iow, if your twitter bio says "express.js contributor", then the policy applies to your tweets.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
TIL. Thanks for that. We should then be very explicit in the wording here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Alright, revising that.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done.