From 22e0743157b5b0f72bb5501d1ed893c6292757d7 Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Wed, 17 May 2023 13:00:42 +0200 Subject: [PATCH 01/13] Update and clarify archival process Signed-off-by: Richard Hartmann --- process/archiving.md | 34 ++++++++++++++++++++++------------ 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/process/archiving.md b/process/archiving.md index 779300b..08e0b51 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -2,29 +2,39 @@ Open source projects have a lifecycle and there are times that projects become inactive due to a variety of reasons. There are also cases where a project may no longer want to be supported by the TOC, or the TOC may no longer wish to recommend the use of a project. -## Archiving Criteria +## Triggering Archiving review -When voting on a proposal to archive a project, TOC members may wish to consider whether the project continues to meet the criteria for CNCF acceptance. The TOC may also look at activity levels in the project (https://all.devstats.cncf.io/d/53/projects-health-table?orgId=1), although it is important to note that there is a difference between a mature project that doesn't get much attention any more but is stable, versus a project that is inactive. +CNCF TOC may also look at a variety of signals, including but not limited to: +* [CNCF Project health dashboard](https://projecthealth.cncf.io/) +* If the project would currently meet criteria for acceptance to CNCF +* Requests for archival by anyone in the wider CNCF community +* Security posture of the project, in particular speedy reaction to and resolution of vulnerability reports +* Project meetings schedules and notes +* Public mailing list activity +* Adoption stats -## Voting Process - -To archive a project: - -* A proposal must be put forth to the TOC repo -* The TOC will inform the project maintainers, CNCF End-User community and wider community of all archiving proposals -* The proposal must remain open for at least 2 weeks of discussion after the maintainers are informed. -* A vote must be finalized with 2/3 approval from the TOC +Automated systems and the references above can trigger a review by the TCO, for example a project might be very mature and close to feature complete, which would be different from general inactiveness. The archival process itself remains manual with close attention to the details by TOC. ## Archiving Process +This is a multi-step process with ample time for projects to react, discuss, and improve built in. Being slow and deliberate is a bug, not a feature. The process can be stopped by TOC consensus at any time until a formal vote has been announced. + +1. Archiving review is triggered (see above). +2. TOC opens an issue inquiring about the health of the project. While there's not fixed timeline, it will be in the order of months. +3. A formal archival request is created in https://github.com/cncf/toc/issues and the issue tracker of the member project, cross-linking both. +4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. +5. A TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. + +## Archiving Status + What does archiving for a CNCF project mean? * CNCF will no longer provide support for the project via service desk -* CNCF will list archived projects online +* CNCF will list the archived project at https://www.cncf.io/archived-projects/ * Trademarks and domain names of archived projects are still hosted by the CNCF and the Linux Foundation * CNCF can provide services such as documentation updates to help transition users. * Other CNCF marketing activities will no longer be provided for the project ## Reactivating an Archived Project -Any project can be reactivated into CNCF by following the normal project [proposal](https://github.com/cncf/toc/blob/main/process/project_proposals.md) and/or [sandbox](https://github.com/cncf/toc/blob/main/process/sandbox.md) process. +Any project can be reactivated into CNCF by following the normal [project proposal](https://github.com/cncf/toc/blob/main/process/project_proposals.md) and/or [sandbox](https://github.com/cncf/toc/blob/main/process/sandbox.md) process. From e8c706521c72869c9c4189d76c57533986f914fd Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Wed, 17 May 2023 13:01:49 +0200 Subject: [PATCH 02/13] Update process/archiving.md Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 08e0b51..8a50548 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -25,7 +25,7 @@ This is a multi-step process with ample time for projects to react, discuss, and 4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. 5. A TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. -## Archiving Status +## Archived Status What does archiving for a CNCF project mean? From 6c0726e75173bad8b4a8f97fe4d602f633784edc Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Wed, 17 May 2023 13:10:42 +0200 Subject: [PATCH 03/13] Add mandatory discussion phase Signed-off-by: Richard Hartmann --- process/archiving.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 8a50548..87ccf8d 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -23,7 +23,8 @@ This is a multi-step process with ample time for projects to react, discuss, and 2. TOC opens an issue inquiring about the health of the project. While there's not fixed timeline, it will be in the order of months. 3. A formal archival request is created in https://github.com/cncf/toc/issues and the issue tracker of the member project, cross-linking both. 4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. -5. A TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. +5. A mandatory two week discussion phase begins +6. A TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. ## Archived Status From 8ba396e81b34844b12e8346de1ad66d09338474e Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 10:49:10 +0200 Subject: [PATCH 04/13] Update process/archiving.md Co-authored-by: Emily Fox <33327273+TheFoxAtWork@users.noreply.github.com> Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 87ccf8d..ede70b9 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -2,7 +2,7 @@ Open source projects have a lifecycle and there are times that projects become inactive due to a variety of reasons. There are also cases where a project may no longer want to be supported by the TOC, or the TOC may no longer wish to recommend the use of a project. -## Triggering Archiving review +## Triggering a Review to Archive CNCF TOC may also look at a variety of signals, including but not limited to: * [CNCF Project health dashboard](https://projecthealth.cncf.io/) From aa7901de3fa179cfe745464baabc29f1e681f1b7 Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 10:49:17 +0200 Subject: [PATCH 05/13] Update process/archiving.md Co-authored-by: Emily Fox <33327273+TheFoxAtWork@users.noreply.github.com> Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index ede70b9..bfbe8bd 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -7,7 +7,7 @@ Open source projects have a lifecycle and there are times that projects become i CNCF TOC may also look at a variety of signals, including but not limited to: * [CNCF Project health dashboard](https://projecthealth.cncf.io/) * If the project would currently meet criteria for acceptance to CNCF -* Requests for archival by anyone in the wider CNCF community +* Requests to archive by anyone in the wider CNCF community * Security posture of the project, in particular speedy reaction to and resolution of vulnerability reports * Project meetings schedules and notes * Public mailing list activity From 73c6984ce767e060faa3f6dd07e1c705cfa052d3 Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 10:49:43 +0200 Subject: [PATCH 06/13] Update process/archiving.md Co-authored-by: Emily Fox <33327273+TheFoxAtWork@users.noreply.github.com> Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index bfbe8bd..5788543 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -13,7 +13,7 @@ CNCF TOC may also look at a variety of signals, including but not limited to: * Public mailing list activity * Adoption stats -Automated systems and the references above can trigger a review by the TCO, for example a project might be very mature and close to feature complete, which would be different from general inactiveness. The archival process itself remains manual with close attention to the details by TOC. +Automated systems and the references above can trigger a review by the TOC. For example a project might be very mature and close to feature complete, which would be different from general inactiveness. The archival process itself remains manual with close attention to the details by TOC. ## Archiving Process From 676ecbc5653c2f0b9859e62244dd7b5e9ab078df Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 10:53:55 +0200 Subject: [PATCH 07/13] Update process/archiving.md Co-authored-by: Emily Fox <33327273+TheFoxAtWork@users.noreply.github.com> Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 5788543..cbe4f93 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -19,7 +19,7 @@ Automated systems and the references above can trigger a review by the TOC. For This is a multi-step process with ample time for projects to react, discuss, and improve built in. Being slow and deliberate is a bug, not a feature. The process can be stopped by TOC consensus at any time until a formal vote has been announced. -1. Archiving review is triggered (see above). +1. Archival review is triggered (see above). 2. TOC opens an issue inquiring about the health of the project. While there's not fixed timeline, it will be in the order of months. 3. A formal archival request is created in https://github.com/cncf/toc/issues and the issue tracker of the member project, cross-linking both. 4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. From 75fac3d892412fb4c7a2829d40b09d6ac5d6c2ab Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 11:08:34 +0200 Subject: [PATCH 08/13] Update PR Signed-off-by: Richard Hartmann --- process/archiving.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/process/archiving.md b/process/archiving.md index cbe4f93..6dcd765 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -35,6 +35,8 @@ What does archiving for a CNCF project mean? * Trademarks and domain names of archived projects are still hosted by the CNCF and the Linux Foundation * CNCF can provide services such as documentation updates to help transition users. * Other CNCF marketing activities will no longer be provided for the project +* The project can not actively advertise being a CNCF project any more, In particular, previous statuses such as Sandbox, Incubating, or Graduated may not be used any more. +* The project is free continue development in its repositories, ideally with a goal to reactivate itself ## Reactivating an Archived Project From 7d95a070a4582c2853953361d54da2c8f38717cb Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 11:15:00 +0200 Subject: [PATCH 09/13] Add cross-ref Signed-off-by: Richard Hartmann --- process/README.md | 7 +------ process/archiving.md | 2 +- 2 files changed, 2 insertions(+), 7 deletions(-) diff --git a/process/README.md b/process/README.md index 6f8e358..893ca1c 100644 --- a/process/README.md +++ b/process/README.md @@ -100,12 +100,7 @@ To archive a project: ### Archiving Process -What does archiving for a CNCF project mean? -* CNCF will no longer provide support for the project via service desk -* CNCF will list archived projects online -* Trademarks and domain names of archived projects are still hosted by the CNCF and the Linux Foundation -* CNCF can provide services such as documentation updates to help transition users. -* Other CNCF marketing activities will no longer be provided for the project +See the [Archiving process](archiving.md). # IV. Annual Review Process diff --git a/process/archiving.md b/process/archiving.md index 6dcd765..412fcfa 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -1,4 +1,4 @@ -# CNCF Project Archiving Process v1.0 +# CNCF Project Archiving Process v1.1 Open source projects have a lifecycle and there are times that projects become inactive due to a variety of reasons. There are also cases where a project may no longer want to be supported by the TOC, or the TOC may no longer wish to recommend the use of a project. From 19076def4a5db815efd81c9f377cc3a54781acb7 Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 15:54:08 +0200 Subject: [PATCH 10/13] Update process/archiving.md Signed-off-by: Richard Hartmann --- process/archiving.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 412fcfa..66ea260 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -24,7 +24,8 @@ This is a multi-step process with ample time for projects to react, discuss, and 3. A formal archival request is created in https://github.com/cncf/toc/issues and the issue tracker of the member project, cross-linking both. 4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. 5. A mandatory two week discussion phase begins -6. A TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. +6. If this step is reached, a TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. +7. ``` ## Archived Status From 3f1341c3f10afd62f71300a6a8f524d1a4371319 Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 15:54:21 +0200 Subject: [PATCH 11/13] Update process/archiving.md Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 66ea260..a17e4d1 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -23,7 +23,7 @@ This is a multi-step process with ample time for projects to react, discuss, and 2. TOC opens an issue inquiring about the health of the project. While there's not fixed timeline, it will be in the order of months. 3. A formal archival request is created in https://github.com/cncf/toc/issues and the issue tracker of the member project, cross-linking both. 4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. -5. A mandatory two week discussion phase begins +5. Once enough information has been provided, CNCF TOC may announce the mandatory two week public comment period 6. If this step is reached, a TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. 7. ``` From 67a0b2f502a32a1621ef8ac62ecdf62917d015bd Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 15:54:30 +0200 Subject: [PATCH 12/13] Update process/archiving.md Signed-off-by: Richard Hartmann --- process/archiving.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index a17e4d1..66d495c 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -17,7 +17,9 @@ Automated systems and the references above can trigger a review by the TOC. For ## Archiving Process -This is a multi-step process with ample time for projects to react, discuss, and improve built in. Being slow and deliberate is a bug, not a feature. The process can be stopped by TOC consensus at any time until a formal vote has been announced. +This is a multi-step process with ample time for projects, adopters, and community members to react, discuss, and develop improvements. As a result, it may take an unspecified time. CNCF TOC's intent is to be deliberate in understanding the state of the project and if the project wants and can to return to an active state. + +The process can be stopped by TOC consensus at any time until a formal vote has been announced. 1. Archival review is triggered (see above). 2. TOC opens an issue inquiring about the health of the project. While there's not fixed timeline, it will be in the order of months. From 7f29b98f13e05b2ed2c82ae26ee0b186d20acfda Mon Sep 17 00:00:00 2001 From: Richard Hartmann Date: Mon, 22 May 2023 15:57:27 +0200 Subject: [PATCH 13/13] Update process/archiving.md Signed-off-by: Richard Hartmann --- process/archiving.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/process/archiving.md b/process/archiving.md index 66d495c..31e4ceb 100644 --- a/process/archiving.md +++ b/process/archiving.md @@ -25,7 +25,7 @@ The process can be stopped by TOC consensus at any time until a formal vote has 2. TOC opens an issue inquiring about the health of the project. While there's not fixed timeline, it will be in the order of months. 3. A formal archival request is created in https://github.com/cncf/toc/issues and the issue tracker of the member project, cross-linking both. 4. TOC informs project maintainers and the end user community. This step will usually be delegated to CNCF staff. -5. Once enough information has been provided, CNCF TOC may announce the mandatory two week public comment period +5. Once enough information has been provided, CNCF TOC may announce a mandatory public comment period of two weeks. This period may be extended by TOC as needed. 6. If this step is reached, a TOC vote is announced; the voting duration is two weeks. A 2/3 majority in favor of archiving is required. 7. ```