From f77ef9acfa67377918eefebd1ba63571746cee58 Mon Sep 17 00:00:00 2001 From: MattIPv4 Date: Thu, 19 Feb 2026 02:29:45 +0000 Subject: [PATCH] Document web-admins team w/ minimal onboarding --- MEMBERS.md | 6 ++++++ PERMISSIONS.md | 4 ++-- README.md | 8 +++++--- onboarding/nodejs-website.md | 2 +- onboarding/web-admins.md | 11 +++++++++++ onboarding/web-infra.md | 4 ++-- 6 files changed, 27 insertions(+), 8 deletions(-) create mode 100644 onboarding/web-admins.md diff --git a/MEMBERS.md b/MEMBERS.md index 9b58974..2128e0b 100644 --- a/MEMBERS.md +++ b/MEMBERS.md @@ -26,3 +26,9 @@ - [@MattIPv4](https://github.com/MattIPv4) - **Matt Cowley** (he/him) - [@MoLow](https://github.com/MoLow) - **Moshe Atlow** (he/him) - [@ovflowd](https://github.com/ovflowd) - **Claudio Wunder** (they/them) + +## Node.js Web Admins Team (`@nodejs/web-admins`) + +- [@bmuenzenmeyer](https://github.com/bmuenzenmeyer) - **Brian Muenzenmeyer** (he/him) +- [@MattIPv4](https://github.com/MattIPv4) - **Matt Cowley** (he/him) +- [@ovflowd](https://github.com/ovflowd) - **Claudio Wunder** (they/them) diff --git a/PERMISSIONS.md b/PERMISSIONS.md index cb2b1bf..ed1a609 100644 --- a/PERMISSIONS.md +++ b/PERMISSIONS.md @@ -26,8 +26,8 @@ | **[Crowdin][]** | Read | - | - | Admin | Admin | Credentials for a user with elevated exist in 1Password. Access to this service may be granted to outside collaborators on a case-by-case, language-by-language basis. | | **[Figma][]** | Read | - | Write | - | - | Access to this service is controlled by the OpenJS Foundation and @avivkeller, and only covers website-related design files. | | **[HackMD][]** | - | - | - | - | Admin | | -| **[Sentry][]** | - | - | - | Admin | Admin | | -| **[Vercel][]** | - | - | - | Developer | Owner | Along with individual access, credentials for a user with elevated exist in 1Password. | +| **[Sentry][]** | - | - | - | Manager | Owner | | +| **[Vercel][]** | - | - | - | Developer | Admin | Along with individual access, credentials for a user with elevated exist in 1Password. | ## Access Tokens & Automations diff --git a/README.md b/README.md index 1fd8964..597d0a0 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,15 @@ # Node.js Web Team Governance Repository -This repository contains the governance documentation, workflows, and shared resources for the Node.js Web Team (@nodejs/web) and its subteams. +This repository contains the governance documentation, workflows, and shared resources for the Node.js Web Team ([`@nodejs/web`](https://github.com/orgs/nodejs/teams/web)) and its subteams. ## Sub-Team Structure The Node.js Web Team consists of two specialized subteams: -- **Website Team** (`@nodejs/nodejs-website`) - Day-to-day website development -- **Web Infra Team** (`@nodejs/web-infra`) - Infrastructure and CI/CD +- **Website Team** ([`@nodejs/nodejs-website`](https://github.com/orgs/nodejs/teams/nodejs-website)) - Day-to-day website development +- **Web Infra Team** ([`@nodejs/web-infra`](https://github.com/orgs/nodejs/teams/web-infra)) - Infrastructure and CI/CD + +_There is also the **Web Admins Team** ([`@nodejs/web-admins`](https://github.com/orgs/nodejs/teams/web-admins)), which is responsible for administrative operations relating to the Web Team._ For detailed information about each team's responsibilities, see [GOVERNANCE.md](GOVERNANCE.md). For current team membership, see [MEMBERS.md](MEMBERS.md). diff --git a/onboarding/nodejs-website.md b/onboarding/nodejs-website.md index 6233343..5de007c 100644 --- a/onboarding/nodejs-website.md +++ b/onboarding/nodejs-website.md @@ -2,5 +2,5 @@ Before onboarding the **Nominee**, ensure they have read and understand the [Collaborator Guide](https://github.com/nodejs/nodejs.org/blob/main/docs/collaborator-guide.md) of the @nodejs/nodejs-website team. -- [ ] Add the **Nominee** to the @nodejs/nodejs-website team on GitHub. +- [ ] Add the **Nominee** to the [`@nodejs/nodejs-website`](https://github.com/orgs/nodejs/teams/nodejs-website) team on GitHub. - [ ] Grant the **Nominee** "Edit" access to the [Figma design file](https://www.figma.com/file/a10cjjw3MzvRQMPT9FP3xz). diff --git a/onboarding/web-admins.md b/onboarding/web-admins.md new file mode 100644 index 0000000..2a59b52 --- /dev/null +++ b/onboarding/web-admins.md @@ -0,0 +1,11 @@ +## @nodejs/web-admins Onboarding + +This document is an outline of the tasks necessary to onboard a new member of the Web Admins team (@nodejs/web-admins). +Before starting the process outlined below, the accepted nominee should go through the [@nodejs/web-infra onboarding process](./web-infra.md) as well, since the Web Admins team will build off the access provided to Web Infra members. + +- [ ] Add the **Nominee** to the [`@nodejs/web-admins`](https://github.com/orgs/nodejs/teams/web-admins) team on GitHub. +- [ ] Add the **Nominee** to the [`@nodejs/web`](https://github.com/orgs/nodejs/teams/web) team on GitHub as a maintainer. +- [ ] Upgrade the **Nominee**'s access to the Node.js Status Page. +- [ ] Upgrade the **Nominee**'s access to the Sentry account for Node.js. +- [ ] The **Nominee** should open an issue in [openjs-foundation/infrastructure](https://github.com/openjs-foundation/infrastructure) requesting `Nodejs Admin Access Group` access in Vercel. +- [ ] The **Nominee** should open an issue in [nodejs/build](https://github.com/nodejs/build) requesting admin access to Cloudflare. diff --git a/onboarding/web-infra.md b/onboarding/web-infra.md index a276e9d..c2bd89b 100644 --- a/onboarding/web-infra.md +++ b/onboarding/web-infra.md @@ -7,11 +7,11 @@ To start the nomination process, see [GOVERNANCE.md](../GOVERNANCE.md). ## Tasks -- [ ] Add the **Nominee** to the @nodejs/web-infra team on GitHub. +- [ ] Add the **Nominee** to the [`@nodejs/web-infra`](https://github.com/orgs/nodejs/teams/web-infra) team on GitHub. - [ ] The **Nominee** should open an issue in [nodejs/admin](https://github.com/nodejs/admin) requesting access to the Web Infra 1Password vault. - [ ] Grant the **Nominee** access to Sentry. - [ ] The **Nominee** should enable physical or passkey 2FA on their Sentry account. -- [ ] Grant the **Nominee** access to Vercel. +- [ ] The **Nominee** should open an issue in [openjs-foundation/infrastructure](https://github.com/openjs-foundation/infrastructure) requesting `Nodejs Developer Access Group` access in Vercel. - [ ] The nominee should enable physical or passkey 2FA on their Vercel account. - [ ] The **Nominee** should add their email to the following aliases (by opening a PR in [nodejs/email](https://github.com/nodejs/email)): - [ ] [`nodejs-crowdin`](https://github.com/nodejs/email/blob/main/iojs.org/aliases.json#L174)