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

doc: clarify moderation in onboarding #41930

Merged
merged 4 commits into from Oct 28, 2022
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
7 changes: 7 additions & 0 deletions onboarding.md
Expand Up @@ -108,8 +108,15 @@ The project has a venue for real-time discussion:
* This is a repository to which all members of the `nodejs` GitHub
organization (not just collaborators on Node.js core) have access. Its
contents should not be shared externally.
* Node.js has a moderation team which you should contact when unsure
Copy link
Member

@Trott Trott Feb 11, 2022

Choose a reason for hiding this comment

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

This is a good place to mention the existence of the @nodejs/moderation team.

about taking action in the Node.js org.
* You can moderate non-collaborator posts yourself. Please
report the moderation action taken in accordance to the moderation
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 is a good place to insert a link to the moderation policy. Additionally (and purely optionally), this is also a good place to mention that collaborators can volunteer for the moderation team and how to do that. (We may also want to try using language like "volunteer" rather than "self-nominate". I think people are more likely to volunteer for something than to nominate themselves for something. Plus volunteer correctly implies that it's a service position whereas nominate might suggest recognition, etc.)

Copy link
Member Author

Choose a reason for hiding this comment

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

I think it might make sense to invert the order of things here maybe? Start with a title indicating this section is about moderation in general (rather than heated debates) and add things like volunteering under it here.

* You can find the full moderation policy
[here](https://github.com/nodejs/admin/blob/HEAD/Moderation-Policy.md).
* There is a full list of moderation team members you can contact
[here](https://github.com/nodejs/moderation#moderation-team-members)
benjamingr marked this conversation as resolved.
Show resolved Hide resolved

## Reviewing pull requests

Expand Down