Skip to content

Commit c8bb6a5

Browse files
Merge pull request #283 from eddie-knight/proposal/health-check-reconciliation
docs: Update health check documentation
2 parents 93d2803 + 81142aa commit c8bb6a5

3 files changed

Lines changed: 20 additions & 9 deletions

File tree

operations/governance.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ The key responsibilities of the TOC are summarized below:
5151
| | [Lifecycle Criteria](./processes/activities.md#lifecycle-criteria) | May | Chair |
5252
| | [Technical Dispute Resolution](./processes/activities.md#technical-dispute-resolution) | As needed | Chair |
5353
| | [Cross-project Synergies](./processes/activities.md#cross-project-synergies) | Routine | Vice Chair or Volunteer |
54-
| | [Project Health Review](./processes/activities.md#project-health-review) | February, May, August, November | Vice Chair or Volunteer |
54+
| | [Project Health Review](./processes/activities.md#project-health-review) | Semi-annual (per project presentation) | Vice Chair or Volunteer |
5555
| | [Lifecycle Transitions](./processes/activities.md#lifecycle-transitions) | As needed | Vice Chair or Volunteer |
5656
| **Landscape Growth** |
5757
| | [Contribution Review](./processes/activities.md#contribution-review) | As needed | Chair & Volunteer |

operations/processes/activities.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The following activities are part of the TOC's collective responsibilities, as d
1010
- **Responsible Party**: TOC Vice Chair or Volunteer TOC Member
1111
- **Outcome**: Review project landscape and recommend opportunities for collaboration
1212
- **Process**:
13-
- Maintain a calendar of quarterly presentations from:
13+
- Maintain a calendar of regular presentations from:
1414
- Incubating projects
1515
- Graduated projects
1616
- SIGs with technical outcomes
@@ -40,12 +40,12 @@ The following activities are part of the TOC's collective responsibilities, as d
4040
## Project Health Review
4141

4242
- **Responsible Party**: TOC Vice Chair
43-
- **Outcome**: Review project activity and recommend actions as necessary
43+
- **Outcome**: Review each project's health at its semi-annual presentation and recommend actions as necessary
4444
- **Process**:
45-
- Prepare quarterly health reports using [FINOS LFX Insight Dashboard](https://insights.lfx.linuxfoundation.org/foundation/finos)
46-
- Assign projects to TOC members for detailed review
47-
- Consolidate findings and recommendations
48-
- Track follow-up actions
45+
- During each project's semi-annual presentation (see [project-reports](../../project-reports/README.md)), review the project's [LFX Insights](https://insights.lfx.linuxfoundation.org/foundation/finos) data to assess compliance with its maintenance requirements, including the applicable OSPS Baseline maturity level
46+
- Record projects found out of compliance, and the support offered
47+
- Track follow-up actions through GitHub Issues
48+
- The TOC may additionally review a project's Insights data between presentations if concerns arise
4949

5050
## Landscape Evolution
5151

project-reports/README.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Project reports are to be submitted as a pull request to the `toc/project-report
2121

2222
3. **Submission:** Maintainers submit a PR with the report at least **two week** before the meeting. TOC members review and comment on PR. Liaison works with the project to address questions.
2323

24-
4. **Presentation:** The Project maintainers present a 10-15 minutes presentation during the TOC meeting. The report PR will be merged after the presentation.
24+
4. **Presentation:** The Project maintainers present a 10-15 minutes presentation during the TOC meeting. As part of the agenda, the TOC reviews the project's [LFX Insights](https://insights.lfx.linuxfoundation.org/foundation/finos) data to assess compliance with its maintenance requirements, including the applicable OSPS Baseline maturity level (Maturity Level 2 for Incubating, Maturity Level 3 for Graduated). The report PR will be merged after the presentation.
2525

2626
5. **Post-Presentation:** TOC will discuss any lifecycle transitions or support needs and create a follow-up GitHub issue if needed.
2727

@@ -46,4 +46,15 @@ This review process applies to projects in the following lifecycle stages, or pr
4646
- **Incubating**
4747
- **Graduated**
4848

49-
*Note: Projects in **Labs** or **Archived** states are not required to participate in the semi-annual review.*
49+
> [!NOTE]
50+
> Projects in **Labs** are not required to participate in the semi-annual review, and health status is evaluated by FINOS staff at their sole discretion.
51+
52+
## Non-participation and unreachable projects
53+
54+
A project that does not complete its semi-annual review — by not presenting, by not submitting a report, or by having no maintainer of record or none reachable — is recorded as out of compliance with the [presentation maintenance requirement](../operations/processes/projects/incubation.md) for that cycle. Per the lifecycle requirements, three consecutive out-of-compliance reviews qualify a project for archival.
55+
56+
For a project with no maintainer of record or none reachable, FINOS staff post a notice on the project's issue board requesting confirmation that the project is maintained, with a response deadline (one month, with a reminder one week prior). If no maintainer responds by the deadline, the cycle is recorded as out of compliance and the project is not scheduled to present.
57+
58+
> [!WARNING]
59+
> Any failed health check may disqualify a project from FINOS Marketing benefits, such as the public listing on the FINOS Landscape or qualification for participation at FINOS events. These elements are exclusively managed at the discretion of FINOS Staff.
60+

0 commit comments

Comments
 (0)