Skip to content

Add Moderation Policy - #6

Closed
IamLizu wants to merge 7 commits into
expressjs:mainfrom
IamLizu:feat/add-moderation-policy
Closed

Add Moderation Policy#6
IamLizu wants to merge 7 commits into
expressjs:mainfrom
IamLizu:feat/add-moderation-policy

Conversation

@IamLizu

@IamLizuIamLizu commented Nov 3, 2024

Copy link
Copy Markdown
Member

As discussed in GitHub issue #270, this pull request presents a draft of the Moderation Policy for the expressjs, jshttp, and pillarjs GitHub organizations. This draft is largely based on the Node.js Moderation Policy, as most of its provisions are deemed suitable for the our organizations.

While the entire document is open for review, I request particular attention to the following items,

  1. The scope of this moderation policy mentions only the GitHub organizations unlike Nodejs, as they have Slack and other communities in scope.
  2. Following Nodejs, I have kept the process of requesting moderation via email, and suggested an example email address as report@expressjs.com.
    • If we decide to not have this approach, we can simply remove the relevant parts of this process.
    • Otherwise, a mailbox creation is suggested.
  3. expressjs/moderation repository should be the home for discussing things related to moderation and a place for moderation requests.
    • If we have the repository, all collaborators should be added.
    • Otherwise, suggesting to create the repository.
    • A label moderation-review to escalate issues
  4. I have added a Requirements section in addition to the existing process of being a Moderator as mentioned in Nodejs model,
    • 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.

Notes

Comment threadModerationPolicy.md Outdated
Co-authored-by: Aravind Nair <22199259+aravindvnair99@users.noreply.github.com>
Comment threadModerationPolicy.md Outdated
Comment threadModerationPolicy.md Outdated
@IamLizu

IamLizu commented Nov 3, 2024

Copy link
Copy Markdown
MemberAuthor

Okay, I will wait for further suggestions from others as well and then do a batch-update.

Comment threadModerationPolicy.md Outdated
Comment threadModerationPolicy.md Outdated
Comment threadModerationPolicy.md Outdated
Comment threadModerationPolicy.md Outdated
@IamLizu
IamLizu requested a review from ljharbNovember 4, 2024 08:48
Comment threadModerationPolicy.md
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,

Copy link
Copy Markdown
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
Copy Markdown
MemberAuthor

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
Copy Markdown
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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I have gotten access setup and will be meeting with Ben next week to sort out details of how we can manage these going forward. Will circle back when we have that sorted out.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Were we able to setup a list for the moderation team? I was wondering if we could move forward on this.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Right now it's not simply a matter of setting up distribution lists. The TC has not gotten consensus to proceed with this.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Yeah, I think this gets my 👍 generally but we for sure need to loop back now that we can all comment on the specifics and make sure we agree we can move forward.

@ctcpip
ctcpip marked this pull request as draft November 4, 2024 22:36

@ctcpipctcpip left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

converting to draft, and would like to discuss this with the TC before moving forward

@CBID2CBID2 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Just gave one suggestion

Comment threadModerationPolicy.md Outdated
Comment on lines +70 to +71
Note that Collaborators may Moderate non-Collaborator Posts at any time without
submitting an initial request (see: [Non-Collaborator Posts][]).

Copy link
Copy Markdown

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

@IamLizuIamLizuNov 5, 2024

Copy link
Copy Markdown
MemberAuthor

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.

@wesleytoddwesleytodd left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Not dropping the approve yet, but I think this is GREAT. I want to spend a bit more time reading it and also comparing to some others in the ecosystem. I will also see if we can get some folks experienced in moderation to help review.

Comment threadModerationPolicy.md

This policy applies to all repositories under these GitHub organizations: expressjs, jshttp, and pillarjs, as well as all Working Groups.

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

Copy link
Copy Markdown
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
Copy Markdown

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
Copy Markdown
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
Copy Markdown
MemberAuthor

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
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Done.

Comment threadModerationPolicy.md
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,

Copy link
Copy Markdown
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.

Comment threadModerationPolicy.md Outdated
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

Copy link
Copy Markdown
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.

Comment threadModerationPolicy.md Outdated
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

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

email update

Comment threadModerationPolicy.md Outdated
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

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

email update

Comment threadModerationPolicy.md Outdated
Comment threadModerationPolicy.md Outdated
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 who made the edit and why.

Copy link
Copy Markdown

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
Copy Markdown
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
Copy Markdown

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.

@IamLizuIamLizuNov 17, 2024

Copy link
Copy Markdown
MemberAuthor

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
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Done.

Comment threadModerationPolicy.md Outdated
Comment threadModerationPolicy.md
- 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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Only TC

Suggested change
- 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.
- Moderation Team members and TC 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.

Comment threadModerationPolicy.md
- 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

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This was added to Node.js, some time later, maybe you will want to add it too.

* Issues, pull requests, discussions, and comments that are believed to be
LLM-generated (e.g a PR coming from a new contributor changing a single file
without clear motivation) should be closed with a comment such as "It seems
you are using a LLM, please stop, this is not bringing any value and is
wasting our time. If you are not using one, please read and follow our
contributing guidelines." Report the user to the moderation repository so they
get blocked if they do it again.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

Makes sense, thanks for the input. I will update it in next change.

@ctcpip

Copy link
Copy Markdown
Member

Closing per expressjs/discussions#270 (comment)

@ctcpipctcpip closed this Apr 28, 2025
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Proposal: Allow moderation rights to Triage team

9 participants

@IamLizu@ctcpip@ljharb@wesleytodd@UlisesGascon@aravindvnair99@bjohansebas@CBID2@jonchurch