From 3fbdc7fd848fd7d341f0f9ade1e1d6aa04ee4c78 Mon Sep 17 00:00:00 2001
From: Marko Bevc <marko@kosli.com>
Date: Mon, 6 Jul 2026 14:27:24 +0100
Subject: [PATCH 1/2] chore: split Helm pages

---
 .github/workflows/update-cli-docs.yml | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/update-cli-docs.yml b/.github/workflows/update-cli-docs.yml
index f1128eb..1fe35ca 100644
--- a/.github/workflows/update-cli-docs.yml
+++ b/.github/workflows/update-cli-docs.yml
@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       kosli_cli_tag:
-        description: 'CLI release tag (e.g. v2.11.2)'
+        description: 'CLI release tag (vX.Y.Z)'
         required: true
   repository_dispatch:
     types: [cli-release]
@@ -78,9 +78,18 @@ jobs:
             https://github.com/kosli-dev/cli.git /tmp/cli-repo
           cd /tmp/cli-repo && git sparse-checkout set charts/k8s-reporter
           cd /tmp/cli-repo/charts/k8s-reporter
-          helm-docs --template-files MINTLIFY.md.gotmpl,_templates.gotmpl,_mintlify_templates.gotmpl
-          mkdir -p $GITHUB_WORKSPACE/helm
-          cp /tmp/cli-repo/charts/k8s-reporter/README.md $GITHUB_WORKSPACE/helm/k8s_reporter.mdx
+
+          rm -f "$GITHUB_WORKSPACE"/helm/k8s_reporter/*.mdx
+          for tmpl in mintlify/*.md.gotmpl; do
+            page=$(basename "$tmpl" .md.gotmpl)
+            helm-docs \
+              --template-files "${tmpl},_mintlify_templates.gotmpl" \
+              --output-file "${page}.generated.md"
+            # helm-docs leaves a trailing blank line; normalize to a single final newline
+            printf '%s\n' "$(cat "${page}.generated.md")" \
+              > "$GITHUB_WORKSPACE/helm/k8s_reporter/${page}.mdx"
+            rm "${page}.generated.md"
+          done
 
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v8

From 714013c74803253e4c4e10a13079dd36accab5fe Mon Sep 17 00:00:00 2001
From: Marko Bevc <marko@kosli.com>
Date: Mon, 6 Jul 2026 14:50:47 +0100
Subject: [PATCH 2/2] chore: split Helm pages - reuse partials

---
 .github/workflows/update-cli-docs.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/update-cli-docs.yml b/.github/workflows/update-cli-docs.yml
index 1fe35ca..d6bbc81 100644
--- a/.github/workflows/update-cli-docs.yml
+++ b/.github/workflows/update-cli-docs.yml
@@ -78,12 +78,12 @@ jobs:
             https://github.com/kosli-dev/cli.git /tmp/cli-repo
           cd /tmp/cli-repo && git sparse-checkout set charts/k8s-reporter
           cd /tmp/cli-repo/charts/k8s-reporter
-
-          rm -f "$GITHUB_WORKSPACE"/helm/k8s_reporter/*.mdx
+          mkdir -p $GITHUB_WORKSPACE/helm/k8s_reporter
+          rm -f $GITHUB_WORKSPACE/helm/k8s_reporter/*.mdx
           for tmpl in mintlify/*.md.gotmpl; do
             page=$(basename "$tmpl" .md.gotmpl)
             helm-docs \
-              --template-files "${tmpl},_mintlify_templates.gotmpl" \
+              --template-files "${tmpl},_templates.gotmpl,_mintlify_templates.gotmpl" \
               --output-file "${page}.generated.md"
             # helm-docs leaves a trailing blank line; normalize to a single final newline
             printf '%s\n' "$(cat "${page}.generated.md")" \