LFN Lifecycle States & Guidelines
LFN Lifecycle States & Guidelines
Introduction
The Linux Foundation Networking umbrella consists of multiple projects at various stages of maturity. This document describes the lifecycle of LFN projects, recognizing that newer projects typically require more hands-on support and resources, while mature, established projects operate with greater independence and self-management.
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.
The Technical Advisory Council (TAC) is responsible for facilitating communication and collaboration among technical projects, making informed recommendations about best practices and collaborative opportunities, and informing the LFN Governing Board about projects under the LFN umbrella and those seeking to join.
Getting Support
Program Management (PM) Support:
Submit tickets via Intercom: support@lfnetworking.org
For project-related questions, onboarding, elections, and general PM assistance
IT Infrastructure Support:
Submit tickets at: https://support.linuxfoundation.org
For technical infrastructure, access issues, and system problems
TAC Questions:
Project Lifecycle Philosophy
As projects mature and their communities develop expertise with LF processes, they naturally evolve toward greater operational independence. This evolution allows LFN PMO and TAC staff to focus support on newer projects and growth initiatives without increasing resources. The lifecycle reflects decreasing staff involvement as projects mature and gain capability, with the goal of communities increasingly managing routine operations while staff remain available as needed.
Project States
Candidate
Projects looking to integrate with the LFN umbrella may be inducted at any lifecycle state, provided they meet The Linux Foundation's proven best practices for success.
Support Level: Assessment and onboarding planning
Sandbox
The Sandbox stage provides an entry point for new projects that align with the LFN mission. This stage is ideal for early-stage projects that require time to explore their community, governance, and technical roadmap.
Support Level: HIGH - Active staff engagement and hands-on support
Maximum LFN staff involvement
Frequent check-ins and guidance
Assistance in establishing processes and community
Priority attention for "new and emerging" projects
Community Readiness: New community requiring significant guidance and process establishment
Incubation
Projects have implemented open-source best practices, with a diverse contributor base, and adhere to open governance principles. They actively cooperate with other LFN projects and contribute to the LFN's scope.
Support Level: MODERATE - Strategic guidance with increasing self-management
Regular staff support with defined touchpoints
Transition planning toward self-management
Guidance on establishing self-sustaining processes
Project beginning to demonstrate operational independence
Community Readiness: Developing community with growing understanding of LF processes, beginning to self-serve on routine matters
Graduated (TAC Project)
Mature projects with established communities, stable operations, and proven governance. These projects have fulfilled earlier-stage requirements, demonstrated diversity and compliance with open-source best practices, and maintain documented processes that they follow consistently.
Support Level: Staff available as needed
Projects typically operate with greater independence
Communities have developed expertise with LF processes
Staff available for escalations and strategic guidance as needed
Access to shared resources and infrastructure
Voting representative on the TAC
Community Readiness: Mature, experienced community with established leaders well-versed in community and processes
Self-Management Expectation: While not all Graduated projects operate identically, the goal is for mature projects to increasingly handle routine operations independently as their communities develop capability. See the Self-Management Framework section below for more details.
Maintenance / LTS (Long Term Support)
Projects that have reached a stable, feature-complete state and are focused on maintenance, bug fixes, security updates, and long-term support rather than active new development. These projects serve important production use cases but have reduced development velocity.
Support Level: Reduced service access, staff available as needed
Projects typically operate independently with community-managed processes
Core infrastructure and security services maintained
Reduced or eliminated access to promotional/marketing services
LFN staff available for critical infrastructure or security issues as needed
Community Readiness: Stable community with minimal activity, focused on maintaining existing functionality rather than growth
Characteristics:
Limited new feature development
Focus on stability, security patches, and bug fixes
Smaller but dedicated maintainer base
Reduced contribution velocity
Production deployments requiring long-term stability
May transition here from Graduated or directly to Archived
Archived
A project can be Archived if it has received no significant commits within the previous 12 months, if the Project's TSC requests archiving, or if the community is no longer active. An Archival Review will be initiated to determine if the project meets the criteria for archiving.
Support Level: Read-only preservation
Code repositories preserved in read-only state
Historical reference maintained
Project Lifecycle Flow
Candidate → Sandbox → Incubation → Graduated → Maintenance/LTS → Archived
↓ ↓
(increased independence) (reduced activity)
Note: Projects may also move directly from Graduated to Archived, or from Maintenance/LTS back to Graduated if development activity resumes.
Moving Between Lifecycle States
Projects can advance through lifecycle stages as they mature, or in some cases move to maintenance or archival states. Each transition has specific criteria and processes.
Transitions Overview
Candidate → Sandbox: Complete LF project formation and present to TAC (Candidate Project Template)
Sandbox → Incubation: Demonstrate implementation of open source best practices, varied contributor base, and open governance (Sandbox Project Template)
Incubation → Graduated: Show project maturity, documented release process, diversity, and readiness for self-management
Graduated → Maintenance/LTS: Project reaches stable state with focus on long-term support rather than new development
Maintenance/LTS → Graduated: Development activity and community engagement resumes
Any State → Archived: Project becomes inactive or TSC requests archival
Guidelines
The guidelines presented below are not strict requirements but represent goals and standards that communities should strive to achieve. The key principle is that support intensity decreases as projects mature, with the goal of communities developing capability to manage routine operations while staff remain available as needed.
These guidelines are suggestive and adaptable to each project's unique circumstances. The TAC evaluates proposals on a case-by-case basis, considering overall health, maturity, and potential. Flexibility and context-specific judgment foster innovation, inclusivity, and growth within the LFN ecosystem.
Development & Code Management
Aspect | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Code Scanning | Initial intake scan | Intake scan conducted for basic security and license compliance | Ad-hoc scanning to catch potential issues early | Mature tooling with continuous scanning of all new submissions | Security-focused scanning only; reduced frequency acceptable |
Seed Code Handoff | Planning stage | Date planned and communicated | Completed (mandatory) | Already completed (mandatory) | N/A - stable codebase |
Coding Standards | Not required | Loosely defined for flexibility | Moderate enforcement | Strict standards with regular reviews | Community-maintained standards |
Governance
Aspect | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Adding/Removing Committers | Not required | Mandatory - documented process required | Mandatory - building diverse team | Mandatory - maintaining quality | Community-managed process |
Adding/Removing PTLs | Not required | Not required - roles may be informal | Mandatory - designated leaders needed | Mandatory - effective leadership crucial | Optional - may have minimal leadership structure |
Sub-Project Lifecycle | Not applicable | Not required - focus on core | May add sub-projects as growth occurs | Add, advance, and archive sub-projects | Sub-projects likely archived or minimal |
Sub-Projects Without Designated Lead | Not applicable | Allowed - not yet formalized | Not recommended | Not allowed - all must have leads | Allowed - reduced activity acceptable |
Dispute Resolution | Not required | Basic mechanism beneficial | Mandatory - defined process needed | Mandatory - crucial for healthy community | Community-managed or minimal |
TSC/TOC Governance | Initial formation | Appointments OK | Some meritocracy with appointments | Full meritocracy - all roles merit-based | Flexible - may revert to appointments |
Documentation
Aspect | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Technical Documentation | Initial planning | Build - initial creation | Build, deploy - comprehensive coverage | Build, deploy, test, debug, upgrade - extensive | Maintain existing - minimal updates |
Contributor Onboarding | Not required | Not required | Simple - basic guidance | Detailed - comprehensive coverage | Minimal - focus on maintenance tasks |
Community Metrics
Aspect | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Company Diversity (past 12 months) | Variable | Variable | Variable | 6 companies suggested | Reduced diversity acceptable |
Contributors (past 12 months) | Few - initial stage | Few - initial stage | 10 or more target | More than 2 dozen | Fewer acceptable - focus on stability |
Release Management | Not applicable | RM consultation with LFN (minimum) | Processes established and documented | Processes followed for each release | Infrequent releases; security/bug fixes only |
CI/CD | Not applicable | Manual methods acceptable | Somewhat integrated | Mostly integrated and automated | Minimal - may be manual for infrequent releases |
Adoption | Not a focus | Not a focus | Not a focus | At least one end user | Existing production deployments |
Security Design Principals | Not a focus | Not a focus | OSSF Scorecard established and tracked | OSSF Scorecard 80%+ to passing | Security patches maintained; scorecard optional |
LFN Services by Lifecycle Stage
Committees
Service | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
TAC Engagement | ✓ | ✓ | ✓ | ✓ | Optional |
Budget
Service | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Project-Specific Budget Requests |
|
| ✓ | ✓ | Limited consideration |
Graduated Project Discretionary Budget |
|
|
| ✓ | Not provided |
Discretionary budgets for Graduated Projects can include: Community Awards, Project-specific digital marketing, Hackathon prizes, Additional TSC F2F meeting funding
LFX Services & Tools
Service | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
LFX Tools | ✓ | ✓ | ✓ | ✓ | ✓ (core services only) |
General Tooling | ✓ | ✓ | ✓ | ✓ | ✓ (Zoom, 1Password, Slack) |
LFX Support | ✓ | ✓ | ✓ | ✓ | Limited |
Release Management Support
Service | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Training on Release Management Process |
| ✓ | ✓ | As needed | As needed |
Assistance Developing Release Process |
| ✓ | ✓ | As needed | As needed |
Release Process Troubleshooting |
| ✓ | ✓ | As needed | As needed |
Post-Release Retrospectives |
| ✓ | ✓ | As needed | As needed |
By Incubation phase, projects should have release management processes that are self-managed by the community. Staff provide training, assistance, and troubleshooting as needed.
Marketing
Service | Candidate | Sandbox | Incubation | Graduated | Maintenance/LTS |
|---|---|---|---|---|---|
Listing on LFN Website | ✓ | ✓ | ✓ | ✓ | ✓ |
Events (Booth Space) |
| ✓ (4th priority) | ✓ (2nd priority) | ✓ (1st priority) | Not provided |
Release Marketing & Communications |
| Major releases: social media |