Project Review Process
- 1 Project Reviews & Induction Criteria
- 2 Project Reviews
- 2.1 Candidate Annoucements
- 2.2 Induction Review
- 2.2.1 Board Induction Review
- 2.3 Health & Lifecycle Reviews
- 2.3.1 Health Review
- 2.3.2 Lifecycle Review
- 2.3.3 Reversal Reviews
- 2.3.3.1 Criteria for Reversal Reviews
- 2.3.3.2 Outcome for Reversal Review
- 3 Archival Review
- 3.1.1 Criteria for Archival Review
- 3.1.2 Archival Revesal
- 3.2 LFN Exit Review
- 4 Disposition of Existing Projects
- 5 Amendment of Technical Governance
Project Reviews & Induction Criteria
Each stage of the LFN project lifecycle comes with various benefits and access to resources. The availability of these benefits is dependent on the project's lifecycle stage, and the adoption of services is optional. LFX tooling is available for all projects, regardless of their current stage. New projects joining the LFN are not required to start at a lower lifecycle stage if they already meet the requirements for a higher stage.
The following table serves as a reference for the different Project Lifecycle states. For more information, please refer to LFN Lifecycle States & Guidelines.
Project State | Summary | Benefits | Tools/Services | Community Goals |
---|---|---|---|---|
Candidate | Projects looking to integrate with LFN. Must meet LFN's best practices. | - Staff assistance in governance, diversity, and community growth - Networking opportunities - Guidance from TAC and LFN projects | LF Formation team support, Project onboarding support by LFN for working on graduation to a Sandbox stage (PM, people resources, Infra, etc.), and Seed funding 6-12 months if funding comes with the project. No LFN funding. Project is self-funded for initial period (ex, 6-12 months) | - Demonstrate alignment with LFN mission - Integrate with existing LFN projects |
Sandbox | Lightweight entry for early-stage projects. | - Staff assistance - LFX tools - Networking opportunities - Guidance from TAC | - LFX Tools: Collaboration tools, Documentation - Collaboration Opportunities: Workshops, Forums - LFN Mailing Lists | - Explore community, governance, and roadmap - Align with LFN mission |
Incubation | Demonstrated progress towards open source best practices. | - All Sandbox benefits - Release management support - Marketing inclusion - Cross-project collaboration | - Release Management Tools - Marketing Support - Cross-Project Collaboration Platforms - LFN Infrastructure | - Active integration with LFN projects - Contributor diversity - Open governance |
Graduated (TAC Project) | Exemplary projects meeting diversity, best practices, and LFN integration. | - All Incubation benefits - Budget for project-specific requests - TAC representation - Marketing inclusion - Cross-project collaboration | - Budget Allocation - TAC Representation - Extended Marketing Support - Cross-Project Collaboration Platforms | - Sustained adherence to best practices - Collaborate with other LFN projects |
Project Reviews
An open source project may request a review from the Technical Advisory Council at any time. Project Reviews are held for a variety of reasons. For each review, the project must instantiate the Project Data Template. If the project has already submitted a template for a past review, you can update it (taking into account any changes to the base template) for the new review.
Additionally, a project must publicly announce its 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 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.
Candidate Annoucements
Information and Criteria for Candidate Projects
Initial Notification: When a project becomes a Candidate, LFN informs the Technical Advisory Council (TAC) and the project team. No formal decision or vote from the TAC is required at this stage. However, the TAC should review the project scope and provide feedback on the candidate project.
Project Presentation: The project is invited to present its proposal to the TAC. This presentation does not require extensive preparatory materials.
Courtesy Communication: A courtesy email is sent to the LFN Board to keep them informed of the new Candidate project.
Six-Month Review: If a project remains in the Candidate stage for six months, a mandatory review by the TAC is required to assess the project's progress and determine next steps. This review is led by the LFN Project Management team.
Induction Review
The LFN Board and TAC both evaluate proposals for new projects to be admitted into the LFN. Projects can be inducted at any level of maturity, provided they meet the necessary requirements. The TAC conducts the review first, followed by the Board.
Information and Criteria for TAC LFN Induction Review
To apply for an LFN Induction Review, projects must provide an up-to-date Project Data Template, and inbound code must pass an "intake scan" as defined by LF Legal. The review focuses on the project's accessible governance, which must minimally specify project roles, release processes, decision-making bodies, dispute resolution mechanisms, and more. The review also checks whether the project scope is within the scope of the LFN.
Step-by-Step instructions can be found in our guide: How to Join the LFN as a Project.
As an outcome of the TAC's LFN Induction Review, the TAC will provide the following feedback to the LFN Governing Board for use as input to the LFN Board's LFN Induction Review:
Summary of findings
Recommendation to accept the project into LFN or not.
Board Induction Review
It is up to the Board to define its own criteria and process for the Board's LFN Induction Review. Such review may include legal, trademark, and license reviews. The TAC strongly recommends the Board make its LFN Induction Review criteria and process public and accept design input from the public.
Budget Guidance: The TAC recommends that the Governing Board allocate no or limited funding to Sandbox projects and that those projects cannot use cross-project funding buckets. Sandbox projects should still be able to take advantage of LFN membership that does not require additional funding, such as logo inclusion in marketing materials or attendance at LFN events.
Health & Lifecycle Reviews
Projects already inducted into the LFN Community will have their community reviewed on a periodic basis by the TAC.
Health Review
The LFN Project Health Review aims to assist the projects in participating in LFN and ensure the project's community remains healthy. The reviews will be based on the content available from LFX tools to minimize the burden on the project's community. Health Reviews can be completed by updating an existing Project Data Template or creating a new one. Once the Project Data Template is submitted, please notify the TAC at lfn-tac@lists.lfnetworking.org of your request for review.
Lifecycle Review
If a project that has already been inducted into the LFN Community wishes to change its Lifecycle State, it can request a Lifecycle Review. Before doing so, it is recommended that the project team reviews the LFN Lifecycle States & Guidelines to understand the expectations for each Lifecycle State. Once the team has decided to seek a Lifecycle State review from the TAC, the Project TSC shall proceed by taking a vote. The review process involves updating an existing Project Data Template or creating a new one. After submitting the Project Data Template, the TAC should be notified at lfn-tac@lists.lfnetworking.org to request the review.
Reversal Reviews
A project, whether in the Graduated or Incubation state, may be reverted to a previous lifecycle state if the TAC, by majority vote, if the TAC determines that the project no longer fulfills the criteria for its current status. Additionally, if the Project's Technical Steering Committee (TSC), by majority vote, requests to move the project back to a lower lifecycle state. Before initiating a Reversion to a different lifecycle state, the TAC must make a sincere effort to reach out to the Project's TSC to discuss the project's future.
Criteria for Reversal Reviews
The mandatory criteria for moving a TAC project to a lower lifecycle state are one of:
A direct request from the Project to be moved to a different lifecycle state
Clear signs of reduced project activity resulting in the project no longer meeting the criteria for its current status, such as project diversity, adherence to open source best practices, or overall LFN participation. This should also include evidence of the TAC's sincere effort to engage the Project's TSC in a constructive discussion.
Outcome for Reversal Review
The TAC will notify the Board immediately of any decision to move a project back to lower lifecycle states.
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 that the project has received no significant commits within the previous 12 months and a demonstration of a good faith effort by the TAC to contact the Project's TSC and come to a positive resolution.
Archival Revesal
A Project may be revived by following the same steps as an Induction Review.
LFN Exit Review
A Project may request to leave the LFN by a 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 its discretion.
Disposition of Existing Projects
As of Jun 12, 2024, OpenDaylight, Anuket, FD.io, ONAP, Nephio are in state Graduated (TAC). L3AF is in a state of Incubation.
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.
Last update by a verbal vote of the TAC on Jun 12, 2024