From 4f2c678f2159a5fc821ef8d40bd29bae282a0484 Mon Sep 17 00:00:00 2001 From: thisisobate Date: Thu, 19 Feb 2026 11:54:26 +0300 Subject: [PATCH 1/4] chore: drop numbered analysis folders and adopt a date format instead Signed-off-by: thisisobate --- analyses/{0001-contour.md => 2021/contour/analysis.md} | 0 analyses/{0005-fluxcd.md => 2021/fluxcd/analysis.md} | 0 analyses/{0003-krator.md => 2021/krator/analysis.md} | 0 .../kubernetes-gateway-api/analysis.md} | 0 .../{0002-notary-project.md => 2021/notary/analysis.md} | 0 analyses/{0004-tremor.md => 2021/tremor/analysis.md} | 0 .../backstage}/backstage-analysis.md | 0 .../backstage}/backstage-doc-survey.csv | 0 .../backstage}/backstage-glossary.md | 0 .../backstage}/backstage-implementation.md | 0 .../backstage}/backstage-insights-summary.md | 0 .../{0008-backstage => 2023/backstage}/backstage-issues.md | 0 analyses/{0008-backstage => 2023/backstage}/index.md | 0 analyses/{0008-backstage => 2023/backstage}/user-roles.md | 0 analyses/{0010-etcd => 2023/etcd}/etcd-analysis.md | 0 analyses/{0010-etcd => 2023/etcd}/etcd-implementation.md | 0 analyses/{0010-etcd => 2023/etcd}/etcd-issues.md | 0 analyses/{0010-etcd => 2023/etcd}/index.md | 0 analyses/{0009-in-toto => 2023/in-toto}/in-toto-analysis.md | 0 .../{0009-in-toto => 2023/in-toto}/in-toto-doc-issues.md | 0 .../in-toto}/in-toto-implementation.md | 0 analyses/{0009-in-toto => 2023/in-toto}/index.md | 0 .../in-toto}/survey-of-existing-doc.md | 0 analyses/{0007-porter.md => 2023/porter/analysis.md} | 0 analyses/{0012-TUF => 2024/TUF}/analysis.md | 0 analyses/{0012-TUF => 2024/TUF}/implementation.md | 0 analyses/{0012-TUF => 2024/TUF}/index.md | 0 analyses/{0012-TUF => 2024/TUF}/issues.md | 0 analyses/{0011-keda => 2024/keda}/index.md | 0 analyses/{0011-keda => 2024/keda}/keda-analysis.md | 0 analyses/{0011-keda => 2024/keda}/keda-implementation.md | 0 analyses/{0011-keda => 2024/keda}/keda-issues.md | 0 .../litmuschaos}/litmuschaos-analysis.md | 0 .../litmuschaos}/litmuschaos-implementation.md | 0 .../litmuschaos}/litmuschaos-issues.md | 0 analyses/{0016-helm => 2025/helm}/helm-analysis.md | 0 analyses/{0016-helm => 2025/helm}/helm-implementation.md | 0 analyses/{0016-helm => 2025/helm}/helm-issues-list.md | 0 analyses/{0015-knative => 2025/knative}/analysis.md | 0 analyses/{0015-knative => 2025/knative}/issues.md | 0 analyses/{0014-vitess => 2025/vitess}/analysis.md | 0 analyses/index.md | 6 ++---- 42 files changed, 2 insertions(+), 4 deletions(-) rename analyses/{0001-contour.md => 2021/contour/analysis.md} (100%) rename analyses/{0005-fluxcd.md => 2021/fluxcd/analysis.md} (100%) rename analyses/{0003-krator.md => 2021/krator/analysis.md} (100%) rename analyses/{0006-gateway-api.md => 2021/kubernetes-gateway-api/analysis.md} (100%) rename analyses/{0002-notary-project.md => 2021/notary/analysis.md} (100%) rename analyses/{0004-tremor.md => 2021/tremor/analysis.md} (100%) rename analyses/{0008-backstage => 2023/backstage}/backstage-analysis.md (100%) rename analyses/{0008-backstage => 2023/backstage}/backstage-doc-survey.csv (100%) rename analyses/{0008-backstage => 2023/backstage}/backstage-glossary.md (100%) rename analyses/{0008-backstage => 2023/backstage}/backstage-implementation.md (100%) rename analyses/{0008-backstage => 2023/backstage}/backstage-insights-summary.md (100%) rename analyses/{0008-backstage => 2023/backstage}/backstage-issues.md (100%) rename analyses/{0008-backstage => 2023/backstage}/index.md (100%) rename analyses/{0008-backstage => 2023/backstage}/user-roles.md (100%) rename analyses/{0010-etcd => 2023/etcd}/etcd-analysis.md (100%) rename analyses/{0010-etcd => 2023/etcd}/etcd-implementation.md (100%) rename analyses/{0010-etcd => 2023/etcd}/etcd-issues.md (100%) rename analyses/{0010-etcd => 2023/etcd}/index.md (100%) rename analyses/{0009-in-toto => 2023/in-toto}/in-toto-analysis.md (100%) rename analyses/{0009-in-toto => 2023/in-toto}/in-toto-doc-issues.md (100%) rename analyses/{0009-in-toto => 2023/in-toto}/in-toto-implementation.md (100%) rename analyses/{0009-in-toto => 2023/in-toto}/index.md (100%) rename analyses/{0009-in-toto => 2023/in-toto}/survey-of-existing-doc.md (100%) rename analyses/{0007-porter.md => 2023/porter/analysis.md} (100%) rename analyses/{0012-TUF => 2024/TUF}/analysis.md (100%) rename analyses/{0012-TUF => 2024/TUF}/implementation.md (100%) rename analyses/{0012-TUF => 2024/TUF}/index.md (100%) rename analyses/{0012-TUF => 2024/TUF}/issues.md (100%) rename analyses/{0011-keda => 2024/keda}/index.md (100%) rename analyses/{0011-keda => 2024/keda}/keda-analysis.md (100%) rename analyses/{0011-keda => 2024/keda}/keda-implementation.md (100%) rename analyses/{0011-keda => 2024/keda}/keda-issues.md (100%) rename analyses/{0013-litmuschaos => 2024/litmuschaos}/litmuschaos-analysis.md (100%) rename analyses/{0013-litmuschaos => 2024/litmuschaos}/litmuschaos-implementation.md (100%) rename analyses/{0013-litmuschaos => 2024/litmuschaos}/litmuschaos-issues.md (100%) rename analyses/{0016-helm => 2025/helm}/helm-analysis.md (100%) rename analyses/{0016-helm => 2025/helm}/helm-implementation.md (100%) rename analyses/{0016-helm => 2025/helm}/helm-issues-list.md (100%) rename analyses/{0015-knative => 2025/knative}/analysis.md (100%) rename analyses/{0015-knative => 2025/knative}/issues.md (100%) rename analyses/{0014-vitess => 2025/vitess}/analysis.md (100%) diff --git a/analyses/0001-contour.md b/analyses/2021/contour/analysis.md similarity index 100% rename from analyses/0001-contour.md rename to analyses/2021/contour/analysis.md diff --git a/analyses/0005-fluxcd.md b/analyses/2021/fluxcd/analysis.md similarity index 100% rename from analyses/0005-fluxcd.md rename to analyses/2021/fluxcd/analysis.md diff --git a/analyses/0003-krator.md b/analyses/2021/krator/analysis.md similarity index 100% rename from analyses/0003-krator.md rename to analyses/2021/krator/analysis.md diff --git a/analyses/0006-gateway-api.md b/analyses/2021/kubernetes-gateway-api/analysis.md similarity index 100% rename from analyses/0006-gateway-api.md rename to analyses/2021/kubernetes-gateway-api/analysis.md diff --git a/analyses/0002-notary-project.md b/analyses/2021/notary/analysis.md similarity index 100% rename from analyses/0002-notary-project.md rename to analyses/2021/notary/analysis.md diff --git a/analyses/0004-tremor.md b/analyses/2021/tremor/analysis.md similarity index 100% rename from analyses/0004-tremor.md rename to analyses/2021/tremor/analysis.md diff --git a/analyses/0008-backstage/backstage-analysis.md b/analyses/2023/backstage/backstage-analysis.md similarity index 100% rename from analyses/0008-backstage/backstage-analysis.md rename to analyses/2023/backstage/backstage-analysis.md diff --git a/analyses/0008-backstage/backstage-doc-survey.csv b/analyses/2023/backstage/backstage-doc-survey.csv similarity index 100% rename from analyses/0008-backstage/backstage-doc-survey.csv rename to analyses/2023/backstage/backstage-doc-survey.csv diff --git a/analyses/0008-backstage/backstage-glossary.md b/analyses/2023/backstage/backstage-glossary.md similarity index 100% rename from analyses/0008-backstage/backstage-glossary.md rename to analyses/2023/backstage/backstage-glossary.md diff --git a/analyses/0008-backstage/backstage-implementation.md b/analyses/2023/backstage/backstage-implementation.md similarity index 100% rename from analyses/0008-backstage/backstage-implementation.md rename to analyses/2023/backstage/backstage-implementation.md diff --git a/analyses/0008-backstage/backstage-insights-summary.md b/analyses/2023/backstage/backstage-insights-summary.md similarity index 100% rename from analyses/0008-backstage/backstage-insights-summary.md rename to analyses/2023/backstage/backstage-insights-summary.md diff --git a/analyses/0008-backstage/backstage-issues.md b/analyses/2023/backstage/backstage-issues.md similarity index 100% rename from analyses/0008-backstage/backstage-issues.md rename to analyses/2023/backstage/backstage-issues.md diff --git a/analyses/0008-backstage/index.md b/analyses/2023/backstage/index.md similarity index 100% rename from analyses/0008-backstage/index.md rename to analyses/2023/backstage/index.md diff --git a/analyses/0008-backstage/user-roles.md b/analyses/2023/backstage/user-roles.md similarity index 100% rename from analyses/0008-backstage/user-roles.md rename to analyses/2023/backstage/user-roles.md diff --git a/analyses/0010-etcd/etcd-analysis.md b/analyses/2023/etcd/etcd-analysis.md similarity index 100% rename from analyses/0010-etcd/etcd-analysis.md rename to analyses/2023/etcd/etcd-analysis.md diff --git a/analyses/0010-etcd/etcd-implementation.md b/analyses/2023/etcd/etcd-implementation.md similarity index 100% rename from analyses/0010-etcd/etcd-implementation.md rename to analyses/2023/etcd/etcd-implementation.md diff --git a/analyses/0010-etcd/etcd-issues.md b/analyses/2023/etcd/etcd-issues.md similarity index 100% rename from analyses/0010-etcd/etcd-issues.md rename to analyses/2023/etcd/etcd-issues.md diff --git a/analyses/0010-etcd/index.md b/analyses/2023/etcd/index.md similarity index 100% rename from analyses/0010-etcd/index.md rename to analyses/2023/etcd/index.md diff --git a/analyses/0009-in-toto/in-toto-analysis.md b/analyses/2023/in-toto/in-toto-analysis.md similarity index 100% rename from analyses/0009-in-toto/in-toto-analysis.md rename to analyses/2023/in-toto/in-toto-analysis.md diff --git a/analyses/0009-in-toto/in-toto-doc-issues.md b/analyses/2023/in-toto/in-toto-doc-issues.md similarity index 100% rename from analyses/0009-in-toto/in-toto-doc-issues.md rename to analyses/2023/in-toto/in-toto-doc-issues.md diff --git a/analyses/0009-in-toto/in-toto-implementation.md b/analyses/2023/in-toto/in-toto-implementation.md similarity index 100% rename from analyses/0009-in-toto/in-toto-implementation.md rename to analyses/2023/in-toto/in-toto-implementation.md diff --git a/analyses/0009-in-toto/index.md b/analyses/2023/in-toto/index.md similarity index 100% rename from analyses/0009-in-toto/index.md rename to analyses/2023/in-toto/index.md diff --git a/analyses/0009-in-toto/survey-of-existing-doc.md b/analyses/2023/in-toto/survey-of-existing-doc.md similarity index 100% rename from analyses/0009-in-toto/survey-of-existing-doc.md rename to analyses/2023/in-toto/survey-of-existing-doc.md diff --git a/analyses/0007-porter.md b/analyses/2023/porter/analysis.md similarity index 100% rename from analyses/0007-porter.md rename to analyses/2023/porter/analysis.md diff --git a/analyses/0012-TUF/analysis.md b/analyses/2024/TUF/analysis.md similarity index 100% rename from analyses/0012-TUF/analysis.md rename to analyses/2024/TUF/analysis.md diff --git a/analyses/0012-TUF/implementation.md b/analyses/2024/TUF/implementation.md similarity index 100% rename from analyses/0012-TUF/implementation.md rename to analyses/2024/TUF/implementation.md diff --git a/analyses/0012-TUF/index.md b/analyses/2024/TUF/index.md similarity index 100% rename from analyses/0012-TUF/index.md rename to analyses/2024/TUF/index.md diff --git a/analyses/0012-TUF/issues.md b/analyses/2024/TUF/issues.md similarity index 100% rename from analyses/0012-TUF/issues.md rename to analyses/2024/TUF/issues.md diff --git a/analyses/0011-keda/index.md b/analyses/2024/keda/index.md similarity index 100% rename from analyses/0011-keda/index.md rename to analyses/2024/keda/index.md diff --git a/analyses/0011-keda/keda-analysis.md b/analyses/2024/keda/keda-analysis.md similarity index 100% rename from analyses/0011-keda/keda-analysis.md rename to analyses/2024/keda/keda-analysis.md diff --git a/analyses/0011-keda/keda-implementation.md b/analyses/2024/keda/keda-implementation.md similarity index 100% rename from analyses/0011-keda/keda-implementation.md rename to analyses/2024/keda/keda-implementation.md diff --git a/analyses/0011-keda/keda-issues.md b/analyses/2024/keda/keda-issues.md similarity index 100% rename from analyses/0011-keda/keda-issues.md rename to analyses/2024/keda/keda-issues.md diff --git a/analyses/0013-litmuschaos/litmuschaos-analysis.md b/analyses/2024/litmuschaos/litmuschaos-analysis.md similarity index 100% rename from analyses/0013-litmuschaos/litmuschaos-analysis.md rename to analyses/2024/litmuschaos/litmuschaos-analysis.md diff --git a/analyses/0013-litmuschaos/litmuschaos-implementation.md b/analyses/2024/litmuschaos/litmuschaos-implementation.md similarity index 100% rename from analyses/0013-litmuschaos/litmuschaos-implementation.md rename to analyses/2024/litmuschaos/litmuschaos-implementation.md diff --git a/analyses/0013-litmuschaos/litmuschaos-issues.md b/analyses/2024/litmuschaos/litmuschaos-issues.md similarity index 100% rename from analyses/0013-litmuschaos/litmuschaos-issues.md rename to analyses/2024/litmuschaos/litmuschaos-issues.md diff --git a/analyses/0016-helm/helm-analysis.md b/analyses/2025/helm/helm-analysis.md similarity index 100% rename from analyses/0016-helm/helm-analysis.md rename to analyses/2025/helm/helm-analysis.md diff --git a/analyses/0016-helm/helm-implementation.md b/analyses/2025/helm/helm-implementation.md similarity index 100% rename from analyses/0016-helm/helm-implementation.md rename to analyses/2025/helm/helm-implementation.md diff --git a/analyses/0016-helm/helm-issues-list.md b/analyses/2025/helm/helm-issues-list.md similarity index 100% rename from analyses/0016-helm/helm-issues-list.md rename to analyses/2025/helm/helm-issues-list.md diff --git a/analyses/0015-knative/analysis.md b/analyses/2025/knative/analysis.md similarity index 100% rename from analyses/0015-knative/analysis.md rename to analyses/2025/knative/analysis.md diff --git a/analyses/0015-knative/issues.md b/analyses/2025/knative/issues.md similarity index 100% rename from analyses/0015-knative/issues.md rename to analyses/2025/knative/issues.md diff --git a/analyses/0014-vitess/analysis.md b/analyses/2025/vitess/analysis.md similarity index 100% rename from analyses/0014-vitess/analysis.md rename to analyses/2025/vitess/analysis.md diff --git a/analyses/index.md b/analyses/index.md index e4c9eae5..ababe3ab 100644 --- a/analyses/index.md +++ b/analyses/index.md @@ -50,11 +50,9 @@ This directory contains completed analyses of the technical documentation for selected CNCF incubating and graduated software projects. The analyses are in one of two formats depending on when they were written. -Earlier analyses (**0001** - **0007**) are Markdown files, each of which is the -sole artifact of the analysis. +Earlier analyses (**2021**) have one project directory per project, and each of those directories contains a single Markdown file as the only analysis artifact. -Subsequent analyses (**0008-** forward) each have their own directory containing -three analysis artifacts: +Subsequent analyses (**2023** onward) also use one directory per project, with each directory containing one or more of these three artifact types: - [analysis.md](../docs/analysis/templates/analysis.md) evaluates the project documentation and provides comments and recommendations in a manner very From c50e6f62b9663068370b042c849e03f45c155724 Mon Sep 17 00:00:00 2001 From: thisisobate Date: Thu, 19 Feb 2026 12:02:08 +0300 Subject: [PATCH 2/4] chore: prettify docs Signed-off-by: thisisobate --- .github/settings.yml | 1 - analyses/index.md | 6 ++++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/.github/settings.yml b/.github/settings.yml index 62a1acfb..6c575c0e 100644 --- a/.github/settings.yml +++ b/.github/settings.yml @@ -125,4 +125,3 @@ labels: - name: CNCF Service Desk description: This issue has a related CNCF Service Desk ticket color: 0CD9EF - diff --git a/analyses/index.md b/analyses/index.md index ababe3ab..8f3ba9e1 100644 --- a/analyses/index.md +++ b/analyses/index.md @@ -50,9 +50,11 @@ This directory contains completed analyses of the technical documentation for selected CNCF incubating and graduated software projects. The analyses are in one of two formats depending on when they were written. -Earlier analyses (**2021**) have one project directory per project, and each of those directories contains a single Markdown file as the only analysis artifact. +Earlier analyses (**2021**) have one project directory per project, and each of +those directories contains a single Markdown file as the only analysis artifact. -Subsequent analyses (**2023** onward) also use one directory per project, with each directory containing one or more of these three artifact types: +Subsequent analyses (**2023** onward) also use one directory per project, with +each directory containing one or more of these three artifact types: - [analysis.md](../docs/analysis/templates/analysis.md) evaluates the project documentation and provides comments and recommendations in a manner very From ad82152ee0dc7f02b5b5ac6016c2e8e40a005a75 Mon Sep 17 00:00:00 2001 From: thisisobate Date: Thu, 19 Feb 2026 12:57:49 +0300 Subject: [PATCH 3/4] chore: update check-md script Signed-off-by: thisisobate --- package.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/package.json b/package.json index d41d791c..ec46faeb 100644 --- a/package.json +++ b/package.json @@ -14,8 +14,8 @@ "_check:markdown:all": "npm run -s _list:check:md | xargs -I {} -P 4 npx -p markdownlint-cli markdownlint -c .markdownlint.yaml {}", "_check:markdown:delta": "npm run -s _list:git:delta | xargs -I {} npx -p markdownlint-cli markdownlint -c .markdownlint.yaml {}", "_list:check:*": "npm run --loglevel=warn | grep -Ee '^\\s*check:[^:]+$'", - "_list:check:md:no-analysis": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*' -a -not -path '*/00*'", - "_list:check:md": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*' | grep -Eve '/000|/0010'", + "_list:check:md:no-analysis": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*' -a -not -path './analyses/*'", + "_list:check:md": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*'", "_list:fix:*": "npm run --loglevel=warn | grep -Ee '^\\s*fix:[^:]+$' | grep -v 'fix:all'", "_list:git:delta": "git diff --name-only --diff-filter=ACMR | grep -E '\\.(js|md|scss|yml|yaml)$'", "build:preview": "npm run _build", From e3b3860f2449fe4637229c8592916163c0fa39a8 Mon Sep 17 00:00:00 2001 From: thisisobate Date: Thu, 19 Feb 2026 13:13:53 +0300 Subject: [PATCH 4/4] chore: nit fix Signed-off-by: thisisobate --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index ec46faeb..a9bd9754 100644 --- a/package.json +++ b/package.json @@ -15,7 +15,7 @@ "_check:markdown:delta": "npm run -s _list:git:delta | xargs -I {} npx -p markdownlint-cli markdownlint -c .markdownlint.yaml {}", "_list:check:*": "npm run --loglevel=warn | grep -Ee '^\\s*check:[^:]+$'", "_list:check:md:no-analysis": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*' -a -not -path './analyses/*'", - "_list:check:md": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*'", + "_list:check:md": "find . -name '*.md' -not -path '*/node_modules/*' -a -not -path '*/.?*' -a -not -path './analyses/*'", "_list:fix:*": "npm run --loglevel=warn | grep -Ee '^\\s*fix:[^:]+$' | grep -v 'fix:all'", "_list:git:delta": "git diff --name-only --diff-filter=ACMR | grep -E '\\.(js|md|scss|yml|yaml)$'", "build:preview": "npm run _build",