Add governance docs
[lfn/process.git] / docs / lifecycle / lifecycle.rst
diff --git a/docs/lifecycle/lifecycle.rst b/docs/lifecycle/lifecycle.rst
new file mode 100644 (file)
index 0000000..82db146
--- /dev/null
@@ -0,0 +1,212 @@
+*********************************************
+Linux Foundation Networking Project Lifecycle
+*********************************************
+
+Introduction
+------------
+
+The Linux Foundation Networking umbrella consists of multiple projects. This
+document describes the lifecycle of those LFN projects.
+
+Each LFN project governs itself. LFN projects may consist of multiple
+subprojects with their own lifecycles. This document's scope is limited to
+top-level LFN projects.
+
+Project Lifecycle
+-----------------
+
+LFN projects have a lifecycle. That lifecycle is characterized by Project
+States and State Transitions.
+
+Project States
+==============
+
++---------------+-------------------------------------------------------------+
+| Project State | State Summary                                               |
++===============+=============================================================+
+| Non-LFN       | Project does not exist or exists outside of LFN.            |
++---------------+-------------------------------------------------------------+
+| Non-TAC       | Project is admitted to the LFN but does not have a          |
+|               | representative on the TAC.                                  |
++---------------+-------------------------------------------------------------+
+| TAC           | Project is granted TAC representation.                      |
++---------------+-------------------------------------------------------------+
+| Archived      | Project is no longer active.                                |
++---------------+-------------------------------------------------------------+
+
+Project State Transitions
+=========================
+
++--------------+-------------------+----------------------+-------------------+
+| From State   | To State          | TAC Review           | Board Review      |
++==============+===================+======================+===================+
+| Non-LFN      | Non-TAC           | LFN Entry Review     | LFN Entry Review  |
++--------------+-------------------+----------------------+-------------------+
+| Non-TAC      | TAC               | TAC Admission Review |                   |
++--------------+-------------------+----------------------+-------------------+
+| *            | Archived          | Archival Review      |                   |
++--------------+-------------------+----------------------+-------------------+
+| *            | Non-LFN           | LFN Exit Review      | LFN Exit Review   |
++--------------+-------------------+----------------------+-------------------+
+
+Project Reviews
+===============
+
+For each review, the project must instantiate the Project Data Template. If the
+project has already submitted a template for a past review, they can update it
+(taking in to account any changes to the base template) for the new review.
+
+Additionally, a project must publicly announce their intention to undergo a
+review at least two weeks prior to the date of the review. The announcement
+must include a link to the instantiated Project Data Template for the review.
+The public may comment on the document. The project must engage with comments,
+answer questions and address feedback.
+
+Reviews must be conducted in a manner that allows a global community to
+participate. For example, at a time that is amenable to as many stakeholders as
+possible and using tooling that is generally accessible.
+
+LFN Entry Review
+****************
+
+The Board and the TAC both review proposals for new LFN projects.
+
+TAC LFN Entry Review
+++++++++++++++++++++
+
+Review by the TAC for creating new projects under the LFN or admitting existing
+non-LFN projects into the LFN.
+
+TAC LFN Entry Reviews should happen before, and provide input into, Board LFN
+Entry Reviews.
+
+Required Information for TAC LFN Admission Review
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+An up-to-date instantiation of the Project Data Template is required for an LFN
+Entry Review.
+
+Criteria for TAC LFN Admission Review
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Mandatory criteria for successful completion of the LFN Entry Review is
+documented governance that is clear, complete, and easily and obviously
+accessible (such as a link from of the project's main page). That governance
+must minimally specify:
+
+* Project Roles.
+* How people come to fill project roles.
+* How people are removed from project roles.
+* Who currently fills all project roles.
+* How disputes are definitively resolved (usually by majority vote).
+* How the governance evolves over time.
+* What is the top level technical decision making body for the project,
+  analogous to a TSC, to which the TAC should look for interfaces.
+
+Outcome for TAC LFN Admission Review
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As an outcome of the TAC's LFN Entry Review, the TAC will provide the following
+feedback to the LFN Governing Board for use as input to the LFN Board's LFN
+Entry Review:
+
+* Summary of findings
+* Recommendation to accept the project into LFN or not.
+
+Board LFN Entry Review
+++++++++++++++++++++++
+
+It is up to the Board to define its own criteria and process of the Board's LFN
+Entry Review. The TAC recommends the Board make its LFN Entry Review criteria
+and process public and accept design input from the public.
+
+TAC Admission Review
+********************
+
+The TAC Admission Review is intended for the TAC to consider whether a
+Non-TAC Project should have a representative on the TAC. It is initiated by a
+TAC Admission Request from the Non-TAC Project.
+
+Required Information for TAC Admission Review
++++++++++++++++++++++++++++++++++++++++++++++
+
+An up-to-date instantiation of the Project Data Template is required for a TAC
+Admission Review.
+
+Criteria for TAC Admission Review
++++++++++++++++++++++++++++++++++
+
+Mandatory criteria for successful completion of the TAC Admission Review are
+maintenance of the mandatory criteria for LFN Entry and demonstration of
+adequate project Diversity, a clear statement of how the Project will select
+its TAC Representative and adherence to the LFN Principles.
+
+Outcome for TAC Admission Review
+++++++++++++++++++++++++++++++++
+
+Upon approval by the TAC of the Admission of a project to the TAC that project
+will be considered a TAC project. The TAC will notify the Board immediately of
+its decision.
+
+Archival Review
+***************
+
+A Project may be Archived if it has received no significant commits within the
+previous 12 months or by a majority vote of the Project's TSC to request the
+project be Archived. Prior to TAC initiation of an Archival Review of a
+Project, a good faith effort must be made to contact the Project's TSC and
+initiate a dialog about the future of the Project.
+
+Criteria for Archival Review
+++++++++++++++++++++++++++++
+
+Mandatory criteria for Archiving a project are one of:
+
+* A clear request from the Project to be archived.
+* Clear evidence of the project has received no significant commits within the
+  previous 12 months and demonstration of a good faith effort by the TAC to
+  contact the Project's TSC and come to a positive resolution.
+
+Outcome for Archival Review
++++++++++++++++++++++++++++
+
+The TAC will notify the Board immediately of any decision to Archive a project.
+
+LFN Exit Review
+***************
+
+A Project may request to leave the LFN by majority vote of its TSC.
+
+Should a project request to leave the LFN, it is the obligation of the TAC to
+forward that request to the Board immediately upon notification.
+
+The Board may cause a project to exit LFN at their discretion.
+
+Recommendations to Candidate Project
+------------------------------------
+
+The TAC will provide the following feedback to the candidate projects for all
+reviews.
+
+* If TAC recommends that the candidate project lifecycle state transition be
+  approved, the TAC will provide recommendations for improving the project.
+* If TAC recommends that the candidate project lifecycle state transition not
+  be approved, the TAC will give feedback about which criteria the project did
+  not adequately meet and what changes to the candidate project would be
+  required to change the TAC's recommendation.
+
+Disposition of Existing Projects
+--------------------------------
+
+OpenDaylight, OPNFV, FD.io, and ONAP are in state TAC. PNDA and SNAS are in
+state Non-TAC. Tungsten Fabric was `conditionally inducted by the Board
+<tf-condit-induct-email_>`__ as Non-TAC and should do an LFN Entry Review once
+the process is established.
+
+.. _tf-condit-induct-email: https://lists.lfnetworking.org/g/TAC/message/250
+
+Amendment of Technical Governance
+---------------------------------
+
+This Technical Governance may be amended by a 2/3 vote of the TAC subject to
+approval by the LFN Board.