Skip to content

doc: document the @nodejs/doc-kit subteam - #176

Merged
ovflowd merged 6 commits into
mainfrom
docs/doc-kit-team
Oct 27, 2026
Merged

ovflowd merged 6 commits into
mainfrom
docs/doc-kit-team

Conversation

@ovflowd

@ovflowd ovflowd commented Aug 29, 2026 •

Copy link
Copy Markdown
Member

We created the @nodejs/doc-kit team on GitHub so contributors to nodejs/doc-kit can be onboarded without handing them the whole Web Team surface, and the docs here never caught up. This PR documents it:

  • PERMISSIONS.md: new @nodejs/doc-kit column. The only non-empty cell is Write on nodejs/doc-kit, everything else, including every external service, is -
  • GOVERNANCE.md: new section covering the team, its scope, and its nomination process, which mirrors @nodejs/web-infra
  • MEMBERS.md: new section, seeded with the current members of the GitHub team
  • onboarding/doc-kit.md: onboarding checklist, deliberately much shorter than web-infra's
  • README.md: two subteams becomes three

The scope is intentionally narrow: Write on nodejs/doc-kit and nothing else. No publishing access for now, so no 1Password vault, no Vercel, no npm scope ownership, those stay with @nodejs/web-infra. Releases still go out through the repo's automated workflow via npm trusted publishing, so this doesn't block anyone from cutting one.

Heads up that touching GOVERNANCE.md pulls in @nodejs/tsc via CODEOWNERS. Happy to split that file into its own PR if y'all would rather land the rest first.

Refs: nodejs/admin#1091

Copilot AI lite review requested due to automatic review settings August 29, 2026 13:15
@ovflowd
ovflowd requested a review from a team as a code owner August 29, 2026 13:15

This comment was marked as low quality.

Comment thread onboarding/doc-kit.md
Comment thread onboarding/doc-kit.md Outdated
Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md Outdated
Comment thread PERMISSIONS.md Outdated
ovflowd and others added 2 commits August 30, 2026 02:00
Co-authored-by: Copilot Autofix powered by AI <[email protected]>
Co-authored-by: Aviv Keller <[email protected]>
Clarified the scope and access rights of the Node.js Doc Kit Team.
Comment thread PERMISSIONS.md Outdated
Comment thread onboarding/doc-kit.md Outdated
Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md Outdated
Comment thread GOVERNANCE.md Outdated
Comment thread README.md Outdated
Comment thread onboarding/doc-kit.md Outdated

@bmuenzenmeyer bmuenzenmeyer left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

with Write - this is a 👍 to me

@ovflowd
ovflowd added this pull request to the merge queue Oct 27, 2026
Merged via the queue into main with commit d72b636 Oct 27, 2026
5 checks passed
@ovflowd
ovflowd deleted the docs/doc-kit-team branch October 27, 2026 01:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants