nodejs / nodejs/admin

Proposal: Define SLAs for moderation team responsiveness

Open
#1,093 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
202
Forks
183
Avg merge
2m
Merged PRs (30d)
1

Description

Part of the moderation policy review framed by openjs-foundation/summit#511, for discussion at the Moderation Roundtable on October 1 (if not resolves to consensus prior).

There are no response time expectations for moderation

The Moderation Policy describes what the moderation team can do but never says how quickly. There are no timelines for acknowledging reports, responding to issues in nodejs/moderation, acting on @nodejs/moderation tags, or onboarding new members. This matters if our community is to be kept safe and we can more confidently model inclusivity and trust.

A recent self-nomination took 7 months to resolve. A collaborator who reports harassment has no idea when someone will look at it. A @nodejs/moderation tag in an issue can go unacknowledged indefinitely.

Proposed SLAs (Service Level Agreement)

Draft timelines for four common moderation surfaces. All times are calendar time.

1. Responding to reports (report@nodejs.org and private emails)
Step SLA
Acknowledge receipt to reporter 24 hours
Begin incident response process 48 hours
2. Responding to issues in nodejs/moderation
Step SLA
Acknowledge the issue 24 hours
Assign a moderator to resolve (if action is needed) 48 hours

The goal here is to help drive conversation in this repo where we typically have open-ended "is this spam?" discussions, that don't have clear steps to resolve.

3. Responding to @nodejs/moderation tags across the org
Step SLA
Acknowledge the tag 24 hours
Triage: resolve in-thread or open a tracking issue in nodejs/moderation 48 hours

[!NOTE]
This is the most nebulous reporting mechanism, but when it happens it's typically in response to an ongoing, active argument or potential CoC violation. Discussion should perhaps first confirm this is a valid reporting mechanism at all.

4. Onboarding new moderation team members
Step SLA
Acknowledge nomination 7 days
TSC vote (on agenda or async) 30 days from submission
Permissions granted after approval 7 days
Total: nomination to active member 45 days maximum

If any step exceeds its SLA, the nominee or any moderation team member may escalate to the TSC chair.

Open questions

  • Are these numbers realistic with current team capacity and time zone coverage?
  • How do we ensure SLA conformance without placing undue burden on volunteers? (See forthcoming proposal on moderation team chair role.)

Action items

  • Consensus on SLA numbers
  • Edit onboarding checklist
  • Add SLAs to the Moderation Policy via PR

Assisted by: Claude Opus


Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing Moderation-Policy.md and the ONBOARDING.md checklist referenced in the action items, then read the linked moderation policy discussion. The work is done when the SLA numbers reach consensus and the onboarding checklist and Moderation Policy are updated through a PR.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.