Proposal: Add a more explicit incident response lifecycle to the Moderation Policy
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 30/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Domain
- documentation
Research direction
Start with Moderation-Policy.md and compare its existing escalation, appeal, and consideration-of-intent sections with the linked CNCF Incident Resolution Procedures. Review the proposal's lifecycle, conflict-of-interest, and no-retaliation additions, along with feedback from the moderation roundtable. Done means consensus is reached and a PR updates the policy accordingly.
Written by the indexing model from the issue text.
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).
[!NOTE]
This proposal has a bit more ambiguity than the others, and should be considered later in the session.
The policy covers content moderation but not larger CoC concerns
The Moderation Policy handles the common cases well: inappropriate posts in a public repo, and spam. Consideration of intent, self-correction opportunities, documentation requirements, and worked scenarios are all defined. Escalation and appeal paths exist.
What's missing is a default or suggested lifecycle for reports that aren't resolved by moderating a single post. Larger-scoped CoC violations have less written guidance for us all to align against. This routinely leaves moderation team members to continually do their best to evaluate many factors at once, and the ambiguity can impact SLAs for moderation and repair.
Some gaps against the policy as written, in my opinion:
- Someone emails
report@nodejs.orgabout an incident, pattern of behavior, a private conversation, or a serious CoC violation. We don't mention acknowledgement to the reporter or the accused. - A report involves conflicting accounts. There is no process for resolving factual disagreements.
- The team needs to check jurisdiction: is this ours, the TSC's (PR #990), or the OpenJS CoC Team's?
- A moderator has a relationship with the accused but is not "directly involved." The recusal requirement only covers direct involvement.
I've done a bit of research and noted that other projects, in particular the CNCF, have better outlined procedures. We can mature here.
Gaps relative to CNCF
The CNCF Incident Resolution Procedures cover these cases. Not all of it applies to a volunteer team, but the structure is useful reference.
| Step | CNCF | Node.js |
|---|---|---|
| Acknowledge receipt | Yes | Reporting channels defined, no acknowledgment step |
| Confirm jurisdiction | Explicit check; transfer or escalate | Not addressed (escalation/appeal paths exist but no intake check) |
| Investigation | Review evidence, interview witnesses | Consideration of intent only |
| Notify the accused | Yes, balances retaliation risk | Collaborators get a chance to self-correct; no general notification step |
| Interim protective measures | Explicit authorization during investigation | Temp blocks exist but not framed as interim measures |
| Conflict of interest | Hard/soft definitions with procedures | Recuse if "directly involved" |
| Communicate results | Defines what to tell reporter and accused | Not addressed |
| No retaliation | Explicit | Not addressed |
The below here would turn into a PR against the Moderation Policy. I include it here for early feedback, and then expect to draft a PR.
Add to the Moderation Policy:
Proposed lifecycle
1. Receive and acknowledge. A moderator acknowledges receipt to the reporter.
2. Confirm jurisdiction. Is this governed by the Node.js CoC? Does the accused's role change who handles it (TSC members per PR #990)? Should this be escalated to the OpenJS CoC Team? If not ours, transfer and notify the reporter.
3. Assess interim protective measures. If there is active harm, the team may hide content, set interaction limits, or temporarily block before the investigation is complete.
[!NOTE]
This is a substantial addition, for us to consider carefully.
4. Investigate. Review available evidence. Contact the reporter for clarification. Interview witnesses where appropriate. Consider intent per existing policy. Write down our evidentiary threshold, per comments in https://github.com/openjs-foundation/cross-project-council/issues/1701#issuecomment-4063822741
5. Notify the accused. Inform them a report was received. Give them an opportunity to respond. Do not disclose the reporter's identity without consent.
6. Decide. Determine action, referencing the enforcement ladder in the Code of Conduct. Document the decision and rationale in nodejs/moderation.
7. Communicate results. Inform the reporter of the outcome. Inform the accused of any action taken and the appeals process.
Conflict of interest
A moderator has a conflict of interest if they are personally involved (reporter, accused, or witness), have a close personal or professional relationship with someone involved, or have another interest that would affect their impartiality. Conflicted moderators disclose and recuse.
No retaliation
Retaliation against someone who reports a CoC concern in good faith or provides information during an investigation is itself a CoC violation.
Not included
This proposal does not cover specific timelines (see SLA proposal), but the two proposals would intertwine and be stewarded by a chair per that proposal.
Prior art
- CNCF Incident Resolution Procedures
- Python PSF Enforcement Procedures
- Contributor Covenant 3.0 "Reporting an Issue" section
Action items
- Feedback period before and during Collab Summit
- PR to add the lifecycle to the Moderation Policy, where more consensus explored
Assisted by: Claude Opus
- Dominant language
- JavaScript
- Stars
- 202
- Forks
- 183
- Avg merge
- 2m
- Merged PRs (30d)
- 1
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from nodejs/admin
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
-
Difficulty 5/5 Over a week Newbie friendliness 30/100
-
Difficulty 1/5 Under an hour Newbie friendliness 35/100
-
tsc-agenda
Difficulty 5/5 Over a week Newbie friendliness 25/100
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
avniproject/avni-client#2135 ·
-
automated broken-link
Difficulty 1/5 Under an hour Newbie friendliness 85/100
-
agent/security hive/hosted-available-lke648397-260827-5n31 security
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
babalae/bettergi-scripts-list#3674 ·
-
A-Release-Notes C-Editing D-Modest S-Ready-For-Implementation
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
bevyengine/bevy-website#2595 ·