From 3032aca589d0439fa6f927dc7f233524b574d690 Mon Sep 17 00:00:00 2001 From: Wu Sheng Date: Mon, 31 Aug 2026 07:42:36 +0800 Subject: [PATCH] Docs: host Helm and SWCK docs on the website MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Both repos carry docs/ with a menu.yml, so their docs can be rendered by the site rather than linked out to GitHub. Kubernetes Helm was GitHub-linked with a single v4.9.0 tree link. It is now website-hosted with Next / Latest / v5.0.0, Latest and v5.0.0 sharing the v5.0.0 tag commit so seo/doc-canonical-map.html points the versioned tree at /latest/. The old v4.9.0 entry is dropped rather than kept alongside: a component cannot mix hosted and GitHub-linked entries, because docs.js runs every entry through doc.sh once repoUrl is present and an external link dies at `cp ./docs/menu.yml` under set -o errexit. repo also moves from skywalking-kubernetes to skywalking-helm, matching the upstream rename that the old name now only reaches by redirect. That puts the docs at /docs/skywalking-helm/, which breaks nothing since this component had no website doc URLs before, and it gives the card a star count — apache/skywalking-kubernetes has no entry in data/stars.yml. SWCK moves Latest onto the v0.11.0 tag commit, adds a v0.11.0 entry on the same commitId, and drops v0.10.0 so the site recommends 0.11.0 only. Verified with npm run docs — the same generation CI runs — followed by a full hugo build. Both trees render, the cards read Next / v5.0.0 and Next / v0.11.0, the in-page version switchers offer next / latest / the release, the canonicals resolve to /latest/readme/, and no GitHub tree links remain on either card. Note for reviewers: v5.0.0 and v0.11.0 are git tags without published release artifacts — no GitHub release object, and the ASF dist still carries helm 4.9.0 and swck 0.10.0 — so the docs will run ahead of what the downloads page offers until those releases land. Removing swck v0.10.0 also retires 17 currently published pages under that tree. --- data/docs.yml | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/data/docs.yml b/data/docs.yml index 5ae1ba1ad4931..8018d3711cb09 100644 --- a/data/docs.yml +++ b/data/docs.yml @@ -330,10 +330,17 @@ icon: helm description: SkyWalking Kubernetes Helm repository provides ways to install and configure SkyWalking in a Kubernetes cluster. The scripts are written in Helm 3. user: apache - repo: skywalking-kubernetes + repo: skywalking-helm + repoUrl: https://github.com/apache/skywalking-helm.git docs: - - version: v4.9.0 - link: https://github.com/apache/skywalking-kubernetes/tree/v4.9.0 + - version: Next + link: /docs/skywalking-helm/next/readme/ + - version: Latest + link: /docs/skywalking-helm/latest/readme/ + commitId: 6fe2c783ba2639b0d9ae62edde25fb4d60f3b5e6 + - version: v5.0.0 + link: /docs/skywalking-helm/v5.0.0/readme/ + commitId: 6fe2c783ba2639b0d9ae62edde25fb4d60f3b5e6 - name: SkyWalking Cloud on Kubernetes icon: kubernetes description: A bridge project between Apache SkyWalking and Kubernetes. @@ -345,10 +352,10 @@ link: /docs/skywalking-swck/next/readme/ - version: Latest link: /docs/skywalking-swck/latest/readme/ - commitId: d299bc05ee230f5f366584054db5b099ca60166f - - version: v0.10.0 - link: /docs/skywalking-swck/v0.10.0/readme/ - commitId: d299bc05ee230f5f366584054db5b099ca60166f + commitId: 29a5ea771330f8b205a9e3a9a876928a1d8914e5 + - version: v0.11.0 + link: /docs/skywalking-swck/v0.11.0/readme/ + commitId: 29a5ea771330f8b205a9e3a9a876928a1d8914e5 - type: Protocol description: list: