Skip to content

Commit 4fe2167

Browse files
authored
Merge pull request #7 from flakey5/flakey5/20250709/gov
Sync GOVERNANCE.md to one in website repo
2 parents c908153 + e40f2fe commit 4fe2167

File tree

1 file changed

+28
-143
lines changed

1 file changed

+28
-143
lines changed

GOVERNANCE.md

Lines changed: 28 additions & 143 deletions
Original file line numberDiff line numberDiff line change
@@ -1,169 +1,54 @@
11
# Node.js Web Team Governance
22

3-
This document describes the governance structure and processes for the Node.js Web Team.
4-
5-
## Overview
6-
7-
The Node.js Web Team (`@nodejs/web`) maintains Node.js's web presence and related projects through four specialized subteams, each with distinct responsibilities and expertise.
8-
9-
## Team Structure
10-
11-
### 1. Node.js Website Team (`@nodejs/nodejs-website`)
12-
13-
**Responsibilities:**
14-
15-
- Day-to-day technical development of [nodejs.org](https://nodejs.org)
16-
- Feature development and enhancement
17-
- Website component creation
18-
- Security issue resolution
19-
- Operational maintenance
20-
21-
The Website Team maintains final decision authority on website issues and pull requests, in accordance with the project's Contribution Guidelines, Collaborator Guidelines, Code of Conduct, and overall Node.js governance.
22-
23-
### 2. Node.js Web Infrastructure Team (`@nodejs/web-infra`)
24-
25-
**Responsibilities:**
26-
27-
- Maintenance of CI/CD pipelines for web projects
28-
- Management of web infrastructure providers\*
29-
- Establishment of technical standards and best practices
30-
- Infrastructure access management
31-
32-
\*Note: This team manages infrastructure specific to the Website (e.g., Vercel). Other shared infrastructure (e.g., Cloudflare) may be managed by other teams such as the Node.js Build WG.
33-
34-
### 3. Node.js Web Standards Team (`@nodejs/web-standards`)
35-
36-
**Responsibilities:**
37-
38-
- Advisory role on web standards (e.g., Ecma262)
39-
- Consultation for Node.js Collaborators, TSC, and Web Team on standards-related matters
40-
- Guidance on standards compliance
41-
42-
This team consists of Node.js Collaborators and external experts with significant web standards experience.
43-
44-
### 4. Node.js UX & Design Team (`@nodejs/ux-and-design`)
45-
46-
**Responsibilities:**
47-
48-
- Advisory role on UX and design matters
49-
- Development of design guidelines and best practices
50-
- Consultation on:
51-
- CSS implementation
52-
- Accessibility standards
53-
- User experience flows
54-
- Component design
55-
56-
This team consists of Node.js Collaborators and external experts with UX and design expertise.
57-
58-
## Membership
59-
60-
Team membership is not time-limited, and there is no fixed size for any subteam.
61-
62-
### Website Team Membership
63-
64-
Members are nominated according to the [Collaborator Guide](https://github.com/nodejs/nodejs.org/blob/main/docs/collaborator-guide.md#becoming-a-collaborator) in the nodejs.org repository. Upon successful nomination, new members should add themselves to [MEMBERS.md](MEMBERS.md) via pull request.
65-
66-
### Web Infrastructure Team Membership
67-
68-
Members are nominated by:
69-
70-
- Node.js Technical Steering Committee (TSC)
71-
- Node.js Build WG, following their Collaborator Guidelines
72-
- Existing Node.js Web Team members (recommendation only)
73-
74-
### Web Standards Team Membership
75-
76-
Members are nominated by:
77-
78-
- Node.js Technical Steering Committee (TSC)
79-
- Existing Node.js Web Team members (recommendation only)
80-
81-
### UX & Design Team Membership
82-
83-
Members are nominated by:
84-
85-
- Node.js Technical Steering Committee (TSC)
86-
- Existing Node.js Web Team members (recommendation only)
87-
88-
### Current Members
89-
90-
The current list of all Web Team members across all subteams is maintained in [MEMBERS.md](MEMBERS.md).
91-
92-
## Governance
3+
The Node.js Web Team (@nodejs/web) is a team in the Node.js Project that is composed by a set of subteams. Each containing specific responsibilities and goals.
934

945
### TSC Oversight
956

96-
Any website change that expresses a position about a global event or group of people requires explicit [TSC](https://github.com/nodejs/TSC/blob/main/TSC-Charter.md#section-4-responsibilities-of-the-tsc) approval through one of these methods:
97-
98-
- Pinging `@nodejs/tsc` and receiving no objections after seven days
99-
- Emailing `[email protected]` and receiving at least one approval with no objections after seven days
100-
101-
### Team Meetings
7+
Any website change that expresses a position about a global event or group of people requires explicit
8+
[TSC](https://github.com/nodejs/TSC/blob/main/TSC-Charter.md#section-4-responsibilities-of-the-tsc)
9+
approval. This can be obtained by pinging `@nodejs/tsc` and receive no objections after seven days,
10+
or by sending an email to `[email protected]` and receive at least one approval and no objections after seven days.
10211

103-
- Individual subteams may hold meetings as needed
104-
- Cross-team coordination happens through issues in this repository
105-
- Governance discussions occur through repository issues and relevant communication channels
12+
### Node.js Website Team (`@nodejs/nodejs-website`)
10613

107-
Any community member or contributor can request discussion topics by creating GitHub Issues. Team members can contribute to discussions by participating in issue threads.
14+
The Node.js Website Team is responsible for the day-to-day technical development of the Node.js Website. This is primarily the development of the website itself, adding new features, pages and components, but also fixing any security issues in the website code, handling operational maintenance, and so on.
10815

109-
### Consensus Seeking Process
16+
The maintainers on the Node.js Website Team are responsible for steering the technical direction of the Node.js Website, and reserve the right to make final decisions on any issues or pull requests, in line with the Contribution Guidelines, Collaborator Guidelines, the Code of Conduct and the overall Governance premises of the Node.js project.
11017

111-
The Web Team follows a [Consensus Seeking](http://en.wikipedia.org/wiki/Consensus-seeking_decision-making) decision-making model for governance matters:
18+
Members of this team are nominated through the guidelines provided in the [Contributing Guidelines](https://github.com/nodejs/nodejs.org/blob/main/CONTRIBUTING.md#becoming-a-collaborator) within the [nodejs.org](https://github.com/nodejs/nodejs.org) repository. After a passed nomination, members should submit a PR to add themselves to the list of current members, shown below.
11219

113-
- For subteam-specific decisions, each subteam follows their established processes
114-
- For cross-team matters, consensus is sought through GitHub Issue discussions with appropriate input from affected subteams
20+
### Node.js Web Infra Team (`@nodejs/web-infra`)
11521

116-
### Pull Request Guidelines
22+
The Node.js Web Infra Team is responsible for maintaining the Infrastructure relating to Node.js's Web Presence. The Node.js Web Infra team has the responsibilities of:
11723

118-
For pull requests to the governance repository:
24+
- Maintaining CI/CD pipelines related to Web Infrastructure
25+
- Maintaining our Infrastructure Providers\*
26+
- Have technical ownership on best-standards and best-practices for our Web Infrastructure (such as Web Frameworks that we use)
11927

120-
**Items requiring consensus seeking:**
28+
Web Infra Team members should have access to be able to maintain the services mentioned above.
12129

122-
- Governance changes
123-
- Significant process modifications
30+
Members of this team are nominated either by the Node.js Technical Steering Committee (TSC) or the Node.js Build WG and follow the guidelines provided in the Collaborator Guidelines of the Node.js Build WG. Note that members of the Node.js Web Team might also recommend people for nomination.
12431

125-
**Items that may be merged with reasonable review time and no dissent:**
32+
\* This team has access to infrastructure providers directly related to the Website only, such as Vercel. Other providers that are shared beyond the Website may be controlled by other teams (for example, the Node.js Build WG owns Cloudflare).
12633

127-
- Errata fixes
128-
- Editorial changes
129-
- Meeting minutes
130-
- Team member updates in MEMBERS.md
131-
- Documentation fixes
132-
- Process clarifications
34+
### Node.js Web Standards Team (`@nodejs/web-standards`)
13335

134-
## Interoperability
36+
The Node.js Web Standards Team is composed of Node.js Collaborators and External Collaborators that have extensive experience or expertisè on Web Standards, such as Ecma262. The Standards Team is responsible for guiding and serving as points of contact when either Node.js Collaborators, the Node.js Technical Steering Committee (TSC), or the Web Team, requires assistance or guidance regarding Web Standards.
13537

136-
The four Node.js Web Team subteams collaborate with complementary roles:
38+
Members of this team are nominated by the Node.js Technical Steering Committee (TSC). Note that members of the Node.js Web Team might also recommend people for nomination.
13739

138-
- **Web Infrastructure Team**: Manages technical infrastructure and CI/CD
139-
- **Website Team**: Handles day-to-day development
140-
- **UX and Design Team**: Provides design guidance
141-
- **Web Standards Team**: Advises on web technologies and standards compliance
40+
### Node.js UX & Design Team (`@nodejs/ux-and-design`)
14241

143-
Together, these teams work to deliver the best possible web experience for the Node.js community and users.
42+
The Node.js UX & Design Team is composed of Node.js Collaborators and External Collaborators that have experience or expertisè with UX & Design. The UX & Design Team is responsible for guiding and serving as points of contact when members of the Node.js Web Team require assistance or guidance regarding UX & Design.
14443

145-
## Developer's Certificate of Origin 1.1
44+
Often members of this team will collaborate on providing best practices and guidelines for the Node.js Website, on matters of UX & Design. Members of this team are also responsible for providing feedback on the Node.js Website, and providing feedback on the Node.js Website's design. (For example, when a discussion arises regarding best practices on topics such as CSS, accessibility, UX flows and intent, or component design, the UX & Design Team has a say on the matter).
14645

147-
By making a contribution to this project, I certify that:
46+
Members of this team are nominated by the Node.js Technical Steering Committee (TSC). Note that members of the Node.js Web Team might also recommend people for nomination.
14847

149-
- (a) The contribution was created in whole or in part by me and I
150-
have the right to submit it under the open source license
151-
indicated in the file; or
48+
## The Interoperability of the Node.js Web Team
15249

153-
- (b) The contribution is based upon previous work that, to the best
154-
of my knowledge, is covered under an appropriate open source
155-
license and I have the right under that license to submit that
156-
work with modifications, whether created in whole or in part
157-
by me, under the same open source license (unless I am
158-
permitted to submit under a different license), as indicated
159-
in the file; or
50+
As seen above, the different teams under the Node.js Web Team umbrella are responsible for having the oversight on different aspects of Node.js's Web-related projects. However, it is important to note that the Node.js Web Team is not a set of siloed teams, but rather a set of teams that work together to achieve the same goal: Providing the best Web Experience for Node.js.
16051

161-
- (c) The contribution was provided directly to me by some other
162-
person who certified (a), (b) or (c) and I have not modified
163-
it.
52+
Following this line of thought, the Web Infra Team is responsible for the technical aspects of the Node.js Website (Infrastructure, Framework, CI/CD, etc); The Website Team is responsible for the day-to-day development of the Node.js Website; The UX and Design Team advise on Design Matters and the Web Standards Team advise on best-practices for Web APIs and Web Technologies/Standards.
16453

165-
- (d) I understand and agree that this project and the contribution
166-
are public and that a record of the contribution (including all
167-
personal information I submit with it, including my sign-off) is
168-
maintained indefinitely and may be redistributed consistent with
169-
this project or the open source license(s) involved.
54+
But above all, the Web Team should work together to better the Web Experience for Node.js, aiming to provide the best experience for Node.js users.

0 commit comments

Comments
 (0)