You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by wu...@apache.org on 2026/08/30 23:43:43 UTC

(skywalking-website) branch master updated: Docs: host Helm and SWCK docs on the website (#910)

This is an automated email from the ASF dual-hosted git repository.

wu-sheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/skywalking-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 93dc6054f391 Docs: host Helm and SWCK docs on the website (#910)
93dc6054f391 is described below

commit 93dc6054f39188aac4d5fa47e8e3d46be392c71e
Author: 吴晟 Wu Sheng <wu...@foxmail.com>
AuthorDate: Mon Aug 31 07:43:37 2026 +0800

    Docs: host Helm and SWCK docs on the website (#910)
    
    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 5ae1ba1ad493..8018d3711cb0 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: