Skip to content

docs: fix broken links#15114

Merged
timdorr merged 2 commits into
remix-run:mainfrom
morgan-coded:docs/fix-broken-anchors
May 29, 2026
Merged

docs: fix broken links#15114
timdorr merged 2 commits into
remix-run:mainfrom
morgan-coded:docs/fix-broken-anchors

Conversation

@morgan-coded

Copy link
Copy Markdown
Contributor

Two sets of internal links point at heading anchors that no longer exist:

  • upgrading/future.md links to the middleware Data-mode setup section as
    #2-typescript-augment-future-for-loaderaction-context, but that heading is step 1
    under "Quick Start (Data Mode)" in how-to/middleware.md, so the correct anchor is
    #1-typescript-augment-future-for-loaderaction-context.
  • tutorials/address-book.md links [root-route] and [react-router-config] to
    ../explanation/special-files#roottsx and #react-routerconfigts. The Special Files
    page is now a stub whose content has moved to the framework-conventions API pages, so
    neither anchor exists. Repointed both to ../api/framework-conventions/root.tsx and
    ../api/framework-conventions/react-router.config.ts, matching the links the Special
    Files page itself now uses.

Docs-only change, branched from main per CONTRIBUTING. No change file needed.

Two sets of internal links pointed at heading anchors that no longer exist:

- upgrading/future.md linked to the middleware Data-mode setup section as
  `remix-run#2-typescript-augment-future-for-loaderaction-context`, but that
  heading is step 1 under "Quick Start (Data Mode)", so the correct anchor
  is `remix-run#1-typescript-augment-future-for-loaderaction-context`.
- tutorials/address-book.md linked `[root-route]` and
  `[react-router-config]` to `../explanation/special-files#roottsx` and
  `#react-routerconfigts`. The Special Files page is now a stub whose
  content moved to the framework-conventions API pages, so neither anchor
  exists. Repointed both to `../api/framework-conventions/root.tsx` and
  `../api/framework-conventions/react-router.config.ts`, matching the
  links the Special Files page itself now uses.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 29, 2026 15:15

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Documentation link fixes updating outdated references to point to current documentation paths.

Changes:

  • Update broken anchor link in middleware docs reference within future.md
  • Update two broken links from explanation/special-files to new api/framework-conventions paths in the address book tutorial

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/upgrading/future.md Corrects anchor fragment for the TypeScript Future augmentation section
docs/tutorials/address-book.md Updates two reference links to new framework conventions doc locations

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@remix-cla-bot

remix-cla-bot Bot commented May 29, 2026

Copy link
Copy Markdown
Contributor

Hi @morgan-coded,

Welcome, and thank you for contributing to React Router!

Before we consider your pull request, we ask that you sign our Contributor License Agreement (CLA). We require this only once.

You may review the CLA and sign it by adding your name to contributors.yml.

Once the CLA is signed, the CLA Signed label will be added to the pull request.

If you have already signed the CLA and received this response in error, or if you have any questions, please contact us at hello@remix.run.

Thanks!

- The Remix team

@remix-cla-bot

remix-cla-bot Bot commented May 29, 2026

Copy link
Copy Markdown
Contributor

Thank you for signing the Contributor License Agreement. Let's get this merged! 🥳

@MichaelDeBoey MichaelDeBoey changed the title docs: fix broken anchor links in upgrading and tutorial guides docs: fix broken links May 29, 2026
@timdorr

timdorr commented May 29, 2026

Copy link
Copy Markdown
Member

Thanks!

@timdorr timdorr merged commit 61edd1c into remix-run:main May 29, 2026
1 check 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.

4 participants