Skip to content

[Docs] Fix broken cross-page links in cookbook and Ascend NPU docs#29518

Open
ajinkyajawale14499 wants to merge 1 commit into
sgl-project:mainfrom
ajinkyajawale14499:docs/fix-cookbook-npu-broken-links
Open

[Docs] Fix broken cross-page links in cookbook and Ascend NPU docs#29518
ajinkyajawale14499 wants to merge 1 commit into
sgl-project:mainfrom
ajinkyajawale14499:docs/fix-cookbook-npu-broken-links

Conversation

@ajinkyajawale14499

@ajinkyajawale14499 ajinkyajawale14499 commented Jun 27, 2026

Copy link
Copy Markdown

Motivation

Four internal documentation links in the cookbook and Ascend NPU docs use relative paths with .md/.mdx file extensions. Under Mintlify these resolve to 404s: site routes are extensionless, and the rest of the docs/cookbook reference pages via absolute /docs and /cookbook routes (docs.json navigation carries no file extensions). This fixes the broken cross-page navigation.

This is the same class of fix as the recently merged #29261 ("[Docs] Fix broken links in cookbook").

Modifications

Converted four links to the canonical site-route form (extensionless, absolute):

File Before After
docs_new/cookbook/autoregressive/Jina/Jina-reranker-m0.mdx ../DeepSeek/DeepSeek-V3_2.md /cookbook/autoregressive/DeepSeek/DeepSeek-V3_2
docs_new/cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx ../../../docs/basic_usage/native_api.mdx#capture-... /docs/basic_usage/native_api#capture-...
docs_new/docs/hardware-platforms/ascend-npus/diffusion/disaggregation.mdx ../ascend_npu.mdx /docs/hardware-platforms/ascend-npus/ascend_npu
(same file) ../../../sglang-diffusion/disaggregation.mdx /docs/sglang-diffusion/disaggregation

All four target pages were verified to exist, and the #capture-expert-selection-distribution-in-moe-models anchor is a real heading in native_api.mdx. The chosen route form matches how every other page links these same targets.

Accuracy Tests

N/A — documentation-only change, no code paths affected.

Speed Tests and Profiling

N/A — documentation-only change.

Checklist

  • Documentation-only change; converted broken extension/relative links to canonical Mintlify routes.
  • Verified all target pages and the referenced anchor exist.
  • No code, kernels, or model forward paths touched (no accuracy/speed impact).

Disclosure: this contribution was prepared with AI assistance (Claude Code). The broken links were found by scanning docs_new for links whose Mintlify route does not resolve, and each fix was verified locally against the actual docs tree and docs.json nav convention.


CI States

Latest PR Test (Base): ✅ Run #28306043601
Latest PR Test (Extra): ❌ Run #28306043551

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 27, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates several documentation files by replacing relative file-based markdown links with clean, absolute-like path links without file extensions. There are no review comments, and the changes look correct and consistent.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Four internal documentation links used relative paths with .md/.mdx
file extensions. Under Mintlify these 404: routes are extensionless and
the rest of the docs/cookbook reference pages via absolute /docs and
/cookbook routes (docs.json nav carries no file extensions). Convert
the four links to the canonical site-route form:

- cookbook/autoregressive/Jina/Jina-reranker-m0.mdx -> DeepSeek-V3.2
- cookbook/autoregressive/DeepSeek/DeepSeek-V4.mdx -> native_api anchor
- docs/hardware-platforms/ascend-npus/diffusion/disaggregation.mdx
  -> NPU install guide + sglang-diffusion disaggregation guide

All four target pages and the referenced anchor were verified to exist.

Signed-off-by: ajinkyajawale14499 <ajinkyajawale14499@gmail.com>
@ajinkyajawale14499 ajinkyajawale14499 force-pushed the docs/fix-cookbook-npu-broken-links branch from 5d85f7a to 8dcc4b8 Compare June 28, 2026 00:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant