Skip to content
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

Draft
wants to merge 7 commits into
base: main
Choose a base branch
from
Draft
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
355 changes: 355 additions & 0 deletions ModerationPolicy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,355 @@
# Moderation policy

If you are not a member of the s and wish to submit a
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
moderation request, please see [Requesting Moderation][].

- [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, as well as all working Groups.
IamLizu marked this conversation as resolved.
Show resolved Hide resolved

Any posts, comments, issues, or pull requests that violate the [Code of Conduct][] are subject to Moderation as defined in this policy.
Copy link
Member

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.

Copy link

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.

Copy link
Member

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.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright, revising that.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.


## 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_
s repositories as well as removing the account from
the s membership.
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
- _Block_ refers to the act of prohibiting an individual GitHub account from any
further participation in the s. A block may be
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
_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.
IamLizu marked this conversation as resolved.
Show resolved Hide resolved

## Requesting Moderation

Anyone may request Moderation of a Post. Requesting Moderation of a Post can be
accomplished in one of four ways:

- Via the [[email protected]][] email address,
Copy link
Member

Choose a reason for hiding this comment

The 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.

Copy link
Member Author

Choose a reason for hiding this comment

The 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?

Copy link
Member

Choose a reason for hiding this comment

The 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][]).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Note that Collaborators may Moderate non-Collaborator Posts at any time without
submitting an initial request (see: [Non-Collaborator Posts][]).
> [!NOTE]
> Collaborators may Moderate non-Collaborator Posts at any time without
submitting an initial request (see: [Non-Collaborator Posts][]).

Copy link
Member Author

@IamLizu IamLizu Nov 5, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @CBID2 👋

Thanks for the suggestion. The formatting change does look good. However, this would require changing the link markup from [][] to []().

If you could make this change, I could commit the suggestion.


Use of the [[email protected]][] email address -- or private email to individual
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just a note to fix all the emails as per the comment above when we can.

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 [[email protected]][] address are currently forwarded
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

email update

to all members of the Moderation Team.

When a request is sent by email to the [[email protected]][] (or directly to a
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

email update

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
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
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 s will be recommended
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
for exclusion from any expressjs 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 who made the edit and why.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

github's "edits" feature already documents who made the edit and what change was made; only the "why" wouldn't be included.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we record the why in a private space?

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i assume that would be the moderation repo. but also i think this will either create a lot of useless noise, or will prevent a lot of helpful corrections, because the "why" will likely be pretty apparent.

Copy link
Member Author

@IamLizu IamLizu Nov 17, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rephrasing it to include only why.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.


### 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, 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

- [IamLizu](https://github.com/IamLizu) -
IamLizu marked this conversation as resolved.
Show resolved Hide resolved
**S M Mahmudul Hasan** <<[email protected]>> (he/him)

## 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
[[email protected]]: mailto:[email protected]
[block other individuals from their personal GitHub accounts]: https://help.github.com/en/articles/blocking-a-user-from-your-personal-account