Skip to content

TKE-50: fix supernode cookbook stale links#62

Draft
wenjiehs wants to merge 1 commit into
tke-workshop:mainfrom
wenjiehs:agent/tke-workshop-doc-change-agent/1c893cc7
Draft

TKE-50: fix supernode cookbook stale links#62
wenjiehs wants to merge 1 commit into
tke-workshop:mainfrom
wenjiehs:agent/tke-workshop-doc-change-agent/1c893cc7

Conversation

@wenjiehs

Copy link
Copy Markdown
Collaborator

Summary

Fixes stale supernode GPU cookbook links reported by TKE-50.

Changes

  • Updated cookbook/supernode/README.md GPU documentation references from the removed /ai-ml/04-gpu-pod-best-practices/ route to the current /ai-ml/training/supernode-gpu/ route.
  • Removed the stale #支持的-gpu-规格 anchor reference because the current target page has no matching section; the local README table remains the source for the listed cookbook specs.
  • Converted the broken ../../LICENSE link in cookbook/supernode/README.md to plain Apache License 2.0, matching the root cookbook README license text without linking to a missing file.
  • Updated directly related cookbook references in cookbook/supernode/deploy_gpu_pod.py and cookbook/supernode/gpu_pod_examples.yaml.

Doc Change Report

  • Source issue: TKE-50 (a177fdf6-b9fd-4dc6-990c-bc267c3baea3)
  • canonical_doc_path: cookbook/supernode/README.md
  • operation_id: tke.supernode.gpu_pod.deploy
  • Modified scope: cookbook/supernode/README.md, cookbook/supernode/deploy_gpu_pod.py, cookbook/supernode/gpu_pod_examples.yaml
  • Fact sources:
    • src/content/docs/ai-ml/training/supernode-gpu.md (repo source; no page update timestamp in file): confirms current generated route source and title 超级节点 GPU.
    • astro.config.mjs (repo source; no page update timestamp): confirms Starlight autogenerates the ai-ml docs tree.
    • src/data/cookbooks.js (repo source; no page update timestamp): already references /ai-ml/training/supernode-gpu/ as the supernode GPU link.
    • cookbook/README.md (repo source; last updated 2026-01-07 in file): existing cookbook license section states Apache License 2.0 without a root LICENSE link.
    • npm run build output: confirms dist/ai-ml/training/supernode-gpu/index.html is generated.
  • Static Compile:
    • find cookbook -name '*.py' -print0 | xargs -0 python3 -m py_compile passed.
    • ruby -e 'require "yaml"; YAML.load_stream(File.read("cookbook/supernode/gpu_pod_examples.yaml"))' passed.
    • git diff --check passed.
    • Scoped stale-link search for 04-gpu-pod-best-practices, ../../LICENSE, and 支持的-gpu-规格 in cookbook/supernode found no matches.
  • Dry Run Compile:
    • npm run build passed.
    • Generated route existence check for dist/ai-ml/training/supernode-gpu/index.html passed.
    • mkdocs build --strict skipped: repository has no mkdocs.yml or mkdocs.yaml.
  • Live Verify: not required; this change only updates documentation links/comments and does not create, delete, or modify Tencent Cloud/TKE resources.
  • Remaining human confirmation: none for this scoped link fix. A separate legal/content decision is still needed if the repository should add a root LICENSE file instead of leaving cookbook license text unlinked.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant