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

sarahyurick merged 3 commits into
NVIDIA-NeMo:mainfrom
lbliii:lbliii/fix-broken-links

Conversation

@lbliii

@lbliii lbliii commented May 15, 2026 •

Copy link
Copy Markdown
Contributor

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

ghost commented May 15, 2026

Copy link
Copy Markdown

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

ghost commented May 15, 2026 •

Copy link
Copy Markdown
Contributor

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

ghost 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.

Thanks!

@sarahyurick

ghost commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

/ok to test 1cfe534

@sarahyurick

ghost commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

/ok to test e3c0f25

This branch was previously deployed

1 inactive deployment
public — e3c0f25f Deployed Jun 3, 2026 by copy-pr-bot[bot] via release / finalize / publish-docs #200
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