Skip to content

docs: fix broken links surfaced in 2026-05-14 scan#1991

Merged
sarahyurick merged 3 commits into
NVIDIA-NeMo:mainfrom
lbliii:lbliii/fix-broken-links
Jun 3, 2026
Merged

docs: fix broken links surfaced in 2026-05-14 scan#1991
sarahyurick merged 3 commits into
NVIDIA-NeMo:mainfrom
lbliii:lbliii/fix-broken-links

Conversation

@lbliii
Copy link
Copy Markdown
Contributor

@lbliii lbliii commented May 15, 2026

Description

Fixes 7 unique broken-link targets (127 occurrences) from the 2026-05-14 scan against docs.nvidia.com/nemo/curator: 5 v25.09 API quicklink cards in reference/index.mdx were missing the /api/ tab prefix; the v25.09 NeMo Framework migration link used /latest/ which 404s (now /25.11/); and two stragglers in readspeech.mdx (v26.04 + main) still pointed at /admin/installation instead of /get-started/installation. The other 121 report rows all target /admin/installation under /latest/ and are deploy-lag — current v26.04 source already uses the new path and fern/docs.yml has the redirect; they clear on next publish.

Usage

cd fern
fern check
fern docs broken-links

Checklist

  • I am familiar with the Contributing Guide.
  • New or Existing tests cover these changes.
  • The documentation is up to date with these changes.

…o tutorial

Resolves 7 distinct broken targets found in the 2026-05-14 scan
(127 occurrences total):

- v25.09 reference/index.mdx: 5 API quicklink cards were missing the
  /api/ tab prefix, so they resolved within the docs tab where those
  pages don't exist. Prepend /api to each href.
- v25.09 migration-guide.mdx: NeMo Framework 2.0 migration link used
  /latest/ which 404s. Repoint to /25.11/ to match v26.02+.
- v26.04 and main readspeech.mdx: Installation page moved from
  /admin/installation to /get-started/installation in v26.04. Update
  the two stragglers still pointing at the old slug.

The remaining 121 reports all point at /admin/installation under
/latest/ and reflect deploy-lag against an older build; the current
v26.04 source already uses /get-started/installation and the redirect
mapping in fern/docs.yml is in place. They will clear on next publish.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii lbliii requested a review from a team as a code owner May 15, 2026 16:39
@lbliii lbliii requested review from praateekmahajan and removed request for a team May 15, 2026 16:39
@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 15, 2026

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 15, 2026

Greptile Summary

This PR fixes 7 unique broken-link targets identified in a 2026-05-14 scan of docs.nvidia.com/nemo/curator, covering 4 files across three versioned docs trees.

  • reference/index.mdx (v25.09): Five API Quicklinks cards were missing the /api/ path prefix; all five hrefs have been corrected. The Tasks card and the Infrastructure/Integration section cards were already correct and are untouched.
  • migration-guide.mdx (v25.09): The external NeMo Framework 2.0 Migration Guide URL used /latest/ which resolves to a 404; pinned to /25.11/.
  • readspeech.mdx (main + v26.04): Both copies still referenced the old /admin/installation path; updated to /get-started/installation.

Confidence Score: 5/5

Pure documentation link fixes with no logic, configuration, or API surface changes — safe to merge.

All four files contain only targeted URL corrections. Each change is narrow (one link per hunk), the surrounding prose is untouched, and the fixes are consistent with the scan report described in the PR description. No code paths, build configs, or cross-file dependencies are affected.

No files require special attention.

Important Files Changed

Filename Overview
fern/versions/v25.09/pages/reference/index.mdx Added /api/ prefix to 5 API Quicklinks card hrefs; the Tasks card and Infrastructure/Integration section cards were already correct and untouched
fern/versions/v25.09/pages/about/release-notes/migration-guide.mdx Updated NeMo Framework 2.0 Migration Guide external URL from /latest/ to /25.11/ to resolve 404
fern/versions/main/pages/curate-audio/tutorials/readspeech.mdx Fixed broken installation guide link from /admin/installation to /get-started/installation
fern/versions/v26.04/pages/curate-audio/tutorials/readspeech.mdx Same /admin/installation → /get-started/installation fix as the main branch version of the same file

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Broken Links - 2026-05-14 Scan] --> B[readspeech.mdx\nmain + v26.04]
    A --> C[migration-guide.mdx\nv25.09]
    A --> D[reference/index.mdx\nv25.09 - 5 cards]

    B --> B1["/admin/installation\n→ /get-started/installation"]
    C --> C1["/nemo-framework/user-guide/latest/\n→ /nemo-framework/user-guide/25.11/"]
    D --> D1["/reference/api-reference/*\n→ /api/reference/api-reference/*"]

    B1 --> E[✅ Fixed]
    C1 --> E
    D1 --> E
Loading

Reviews (3): Last reviewed commit: "Merge branch 'main' into lbliii/fix-brok..." | Re-trigger Greptile

@lbliii lbliii requested review from ayushdg and sarahyurick May 15, 2026 16:45
Copy link
Copy Markdown
Contributor

@sarahyurick sarahyurick left a comment

Choose a reason for hiding this comment

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

Thanks!

@sarahyurick
Copy link
Copy Markdown
Contributor

/ok to test 1cfe534

@sarahyurick
Copy link
Copy Markdown
Contributor

/ok to test e3c0f25

@sarahyurick sarahyurick enabled auto-merge (squash) June 3, 2026 16:59
@sarahyurick sarahyurick merged commit 7fb5a75 into NVIDIA-NeMo:main Jun 3, 2026
31 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants