Skip to content
This repository has been archived by the owner on Nov 1, 2022. It is now read-only.

Commit

Permalink
Merge pull request #30 from mkdolan/patch-1
Browse files Browse the repository at this point in the history
Draft Node.js Foundation technical governance documents
  • Loading branch information
piscisaureus committed Mar 30, 2015
2 parents c9e1218 + b2b993d commit 0609b04
Show file tree
Hide file tree
Showing 3 changed files with 212 additions and 0 deletions.
103 changes: 103 additions & 0 deletions governance-proposal/TSC-Charter-Draft.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
## ***DRAFT for Public Comment***

# Technical Steering Committee (TSC) Charter

## Section 1. Guiding Principle.

The Node.js Foundation will operate transparently, openly, collaboratively, and ethically. Project proposals, timelines, and status must not merely be open, but also easily visible to outsiders.

## Section 2. Evolution of Node.js Foundation Governance.

Most large, complex open source communities have both a business and a technical governance model. Node.js Foundation’s technical leadership contains both a Technical Steering Committee (“TSC”) and Maintainers for major components or subsystems. Node.js Foundation’s business leadership is instantiated in a Board of Directors (the “Board”).

This Technical Steering Committee Charter reflects a carefully constructed balanced role for the TSC and the Board in the governance of Node.js Foundation. The charter amendment process is for the TSC to propose changes using simple majority of the full TSC, the proposed changes being subject to review and approval by the Board. The Board may additionally make amendments to the TSC charter at any time, though the Board will not interfere with day-to-day discussions, votes or meetings of the TSC.

## Section 3. Board’s Role in Setting Node.js Foundation’s Strategic Direction.

The Board will set the overall TSC Policy. The policy will describe the overarching scope of the Node.js Foundation initiative, Node.js Foundation’s technical vision and direction and project release expectations in the form of expected cadence and intent. The Board will use the TSC as a delegate body for governing technical implementation, individual project scope and direction while they remain within the scope and direction of the policies as described in the TSC Policy document and approved by the Board.

## Section 4. Establishment of the TSC.

TSC memberships are not time-limited. There is no fixed size of the TSC. However, the expected target is between 6 and 12, to ensure adequate coverage of important areas of expertise, balanced with the ability to make decisions efficiently.

There is no specific set of requirements or qualifications for TSC membership beyond these rules. The TSC may add additional members to the TSC by a standard TSC motion and vote. A TSC member may be removed from the TSC by voluntary resignation, or by a standard TSC motion.

Changes to TSC membership should be posted in the agenda, and may be suggested as any other agenda item.

No more than one-fourth of the TSC members may be affiliated with the same employer. If removal or resignation of a TSC member, or a change of employment by a TSC member, creates a situation where more than one-fourth of the TSC membership shares an employer, then the situation must be immediately remedied by the resignation or removal of one or more TSC members affiliated with the over-represented employer(s).

The TSC members shall consist of Maintainers from Core Projects as defined in the project lifecycle document and Section 7.

The TSC shall meet regularly using tools that enable participation by the community (e.g. weekly on a Google Hangout On Air, or through any other appropriate means selected by the TSC). The meeting shall be directed by the TSC Chairperson. Minutes or an appropriate recording shall be taken and made available to the community through accessible public postings.

## Section 5. Responsibilities of the TSC.

Subject to such policies as may be set by the Board, the TSC is responsible for all technical development within the Node.js Foundation, including:

* Setting release dates
* Release quality standards
* Technical direction
* Project governance and process (including this policy)
* GitHub repository hosting
* Conduct guidelines
* Maintaining the list of additional Collaborators
* Development process and any coding standards
* Mediating technical conflicts between Collaborators or Foundation projects

The TSC will define Node.js Foundation’s release vehicles and serve as Node.js Foundation’s primary technical liaison body with external open source projects, consortiums and groups.

## Section 6. Node.js Foundation Operations.

The TSC will establish and maintain a development process for Node.js Foundation Projects. The development process will establish guidelines for how the developers and community will operate. It will, for example, establish appropriate timelines for TSC review (e.g. agenda items must be published at least a certain number of hours in advance of a TSC meeting).

There will be multiple Projects under the Node.js Foundation organized by modules or subsystems. The TSC is responsible for organizing the Project structure, including possibly the creation and alignment of sub-Projects. Each Project must be within such policies as may be set by the Board, have a well-defined scope and must work within that scope. The development process will provide for Projects to follow the lifecycle process as described in the Project Lifecycle document. The development process will include a process for the TSC to oversee and approve changes in the lifecycle of a Project, which will include consideration of the following criteria:

* Cleanliness of code base
* Ample and diverse Contributors and Collaborators to assure vitality of the project.
* Stability (e.g. presence of test suites, stable APIs and use of an appropriate source-code control system).
* Predictability of releases
* Alignment with Node.js Foundation’s goals and priorities.

The TSC and entire technical community will follow any processes as may be specified by the Board relating to the intake and license compliance review of contributions, including the Node.js Foundation IP Policy.

## Section 7. Elections

Leadership roles in Node.js Foundation will be peer elected representatives of the community.

For election of persons (TSC Chairperson, Maintainers, etc.) a multiple-candidate method should be used, e.g.:

* [Condorcet](http://en.wikipedia.org/wiki/Condorcet_method) or
* [Single Transferable Vote](http://en.wikipedia.org/wiki/Single_transferable_vote)

Multiple-candidate methods may be reduced to simple election by plurality when there are only two candidates for one position to be filled. No election is required if there is only one candidate and no objections to the candidates election. Elections shall be done within the Projects by the Collaborators active in the Project.

Each Core Project’s Collaborators shall elect one Maintainer from the Collaborators on the project to serve on the TSC. There may be only one Maintainer per Core Project that shall be nominated and elected by the Collaborators within the Core Project.

The TSC will elect from amongst voting TSC members a TSC Chairperson to work on building an agenda for TSC meetings and represent the TSC to the Board for a term of one year according to the Node.js Foundation’s By-laws. The TSC shall hold annual elections to select a TSC Chairperson; there are no limits on the number of terms a TSC Chairperson may serve.

## Section 8. Voting

For internal project decisions, Collaborators shall operate under Lazy Consensus. The TSC shall establish appropriate guidelines for implementing Lazy Consensus (e.g. expected notification and review time periods) within the development process.

The TSC follows a [Consensus Seeking](http://en.wikipedia.org/wiki/Consensus-seeking_decision-making) decision making model. When an agenda item has appeared to reach a consensus the moderator will ask "Does anyone object?" as a final call for dissent from the consensus.

If an agenda item cannot reach a consensus a TSC member can call for either a closing vote or a vote to table the issue to the next meeting. The call for a vote must be seconded by a majority of the TSC or else the discussion will continue. Simple majority wins, with the following exceptions, which will require the affirmative vote of two-thirds of the members of the TSC to pass:

* Adding or removing members of the TSC
* Changes to the TSC Charter (which also require Board approval)

## Section 9. Project Roles

The Node.js Foundation git repository is maintained by the TSC and additional Collaborators who are added by the TSC on an ongoing basis.

Individuals making significant and valuable contributions, “Contributor(s)”, are made Collaborators and given commit-access to the project. These individuals are identified by the TSC and their addition as Collaborators is discussed during the weekly TSC meeting. Modifications of the contents of the git repository are made on a collaborative basis as defined in the development process.

Collaborators may opt to elevate significant or controversial modifications, or modifications that have not found consensus to the TSC for discussion by assigning the `tsc-agenda` tag to a pull request or issue. The TSC should serve as the final arbiter where required. The TSC will maintain and publish a list of current Collaborators by Project, as well as a development process guide for Collaborators and Contributors looking to participate in the development effort.

## Section 10. Definitions

Contributors: contribute code or other artifacts, but do not have the right to commit to the code base. Contributors work with the Project’s Collaborators to have code committed to the code base. A Contributor may be promoted to a Collaborator by the projects’ Maintainer or the TSC. Contributors should rarely be encumbered by the TSC and never by the Board.

Project: a technical collaboration effort, e.g. a subsystem, that is organized through the project creation process and approved by the TSC.

* **Maintainer**: a Collaborator within a Core Project elected to represent the Core Project on the TSC.
31 changes: 31 additions & 0 deletions governance-proposal/TSC-Policy-Draft.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
## ***DRAFT for Public Comment***

# Node.js Foundation TSC Policy

The Board of Directors of Node.js Foundation has set in place the following policies to govern the operation of the Technical Steering Committee (TSC). These policies relate to release processes, technical scope, business goals, etc. The TSC will, to the best of its ability, adhere to these policies. In cases where the TSC makes a judgment that the goals of Node.js Foundation are better served by making exceptions to these policies, it is expected that the TSC will communicate these exceptions and indicate their reasons to the Board at the next Board meeting.

The scope of projects chosen by the TSC will focus on the subsystems, modules, scripts, tools or infrastructure to support Node.js.

Node.js Foundation will support projects focused on the following:
* Code development
* Platform Integration & Testing
* Documentation
* Collaboration with external projects
* Other projects that the TSC determines will improve Node.js

The following relate to the projects initiated by the TSC and the artifacts created therein.
* **Singularity**: To the extent possible, there should be no overlap between the significant functions of the Core projects.
* **Cohesiveness**: The artifacts created within each Core project should connect appropriately to other Core Projects to form a cohesive system. It is understood that this will not apply to artifacts that are stand-alone by design or dependencies external to the Foundation.
* **Non-interference**: The artifacts created should work in any configuration and not create negative interference with each other’s functionality.

The following relate to the choice of projects, assignments of tasks and delivery of code.
* **Simultaneous Release**: The TSC is responsible for organizing a simultaneous release of appropriate projects at regular intervals.

The following relate to the operation of the TSC.
* **Communication**: All communication between and within the TSC and Projects will be in a fair, open and consistent fashion.
* **Openness**: The TSC should ensure that all technical decisions are made in an open and transparent fashion.
* **Responsive to Collaborators**: The TSC should ensure issues and needs of the Collaborator community are being addressed in a timely fashion. Collaborators may opt to elevate pull requests or issues to the TSC for discussion by assigning the `tsc-agenda` tag. This should be done where a pull request:
* has a significant impact on the codebase,
* is inherently controversial; or
* has failed to reach consensus amongst the Collaborators who are actively participating in the discussion.
* The TSC should serve as the final arbiter where required.
78 changes: 78 additions & 0 deletions governance-proposal/TSC-Project-Lifecycle.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
## ***DRAFT for Public Comment***

# Node.js Foundation Project Lifecycle

Node.js Foundation’s technical Projects shall follow a lifecycle described in this Project Lifecycle document.

The TSC shall create, align and coordinate Projects that are ideally developed together, including possibly, the creation of sub-Projects. The TSC shall have the power to reorganize Projects and sub-Projects after sufficient review and discussion with the Projects and community involved.

The TSC shall encourage new Projects and innovation in the technical community. New Projects enter the Node.js technical community through a Proposal to the TSC and if approved, are granted Incubation-state status.

Projects shall change state following TSC reviews. Projects typically change states independently from each other, but can cooperate closely and leverage each other’s results. Projects graduate from Proposal-state, through Incubation-state and Mature-state to Core-state. Archived–state is a Project state reserved for those Projects no longer being actively developed or used by the community.

The TSC shall have the authority to grandfather proposed Projects with a significant history and record to meet the project state descriptions below into a higher order state during the first 12 months after the first TSC meeting.

| Project state | Description |
| ------------- | ----------- |
| Proposal | Project does not formally exist yet, may not have real resources (yet), but is being worked on by the community to submit a formal proposal to the TSC. |
| Incubation | Project has been approved by the TSC, has resources, but is recognized to be nascent. |
| Mature | Project is fully functioning and stable, has achieved successful releases, has a Project Lead, but is not a required component of the platform.|
| Core | Project is a required component of the Node.js platform.|
| Archived | Project has been recognized as no longer being actively used or developed. This could be for a variety of reasons, e.g. project successfully accomplished its goals but is no longer used, project failed, etc., and has been archived as it's no longer a going concern.|

### Project state transitions

| From State | To State | Review |
| ---------- | -------- | ------ |
| `null` | Proposal | n/a |
| Proposal | Incubation | Creation Review |
| Incubation | Mature | Graduation Review |
| Mature | Core | Core Review |
| Proposal, Incubation, Mature, Core | Archived | Archive Review |

## Reviews

### Creation Review
* Proposal posted for two weeks, evaluated on metrics of:
* Name is okay (e.g. no use of a trademark)
* Project contact name and email
* Description is complete
* Scope and project plan is well defined
* Resources are committed
* Initial Committers named
* Contributors have been identified
* Meets Foundation’s policies (e.g. IP Policy)
* Proposal has been socialized with potentially interested or affected existing Projects
* Proposal email has been sent to the TSC mailing list
* Review by TSC: Confirm that the proposal is complete and the above listed requirements have been sufficiently met.

### Graduation Review
* Graduation proposal posted for two weeks:
* The Project demonstrates stable output (code base, documents, tests)
* Active community working on the Project
* History of successful, consistent releases in accordance with the release process
* TSC review
* Working and stable code base exists
* Active community exists
* Project has demonstrated a history of releases following the release process and cadence
* Confirmed acceptance and successful integration of contributions/code to partner/upstream projects. 
* Testing/integration environment defined and mature, tests and integration run successfully
* Detailed documentation available documenting the code
### Core Review
* Core-state proposal posted for two weeks
* Project is shown to be viable, necessary or broadly useful module, subsystem or component of Node.js
* Project build and test scripts have been created to work with the rest of Platform build
* Project shown to not break continuous development and integration environment 
* TSC review metrics
* Core review assesses projects based on the metrics of the graduation review and the necessity of the project relative to the codebase and user requirements.
* In addition the project is required to have confirmed longevity (e.g. the project has been active for at least one year, participates in release activities, and has release plans outlined to stay active for at least another year). 

### Termination Review
* Termination proposal posted for two weeks
* States reason for project termination being sought
* Termination proposal to include acceptable triggers for termination
* (e.g. protracted idleness, or request by the project)
* Estimates impact on other projects and how to mitigate
* Impact and possible breakage to APIs or builds
* Location identified and links created for archived project
* If Archival is not approved, the Project remains in its pre-reviewed state

0 comments on commit 0609b04

Please sign in to comment.