Skip to content

Fix 36 broken anchor links and document anchor generation in AGENTS.md - #7024

Open
emmanueletienne-blip wants to merge 2 commits into
mainfrom
devin/1789965585-fix-broken-anchors
Open

emmanueletienne-blip wants to merge 2 commits into
mainfrom
devin/1789965585-fix-broken-anchors

Conversation

@emmanueletienne-blip

@emmanueletienne-blip emmanueletienne-blip commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes every /learn/...#fragment link on the live site whose fragment does not exist on the target page (the 36 broken-anchor findings baselined in #6991). Each replacement id was confirmed present in the rendered production HTML of the target page.

Most are stale fragments from renamed headings, e.g.

#install-fern-cli(-locally)        -> #installation
#page-actionsoptions.mcp           -> #page-actionsoptionsmcp   (punctuation is dropped from ids)
#extraDependencies                 -> #extradependencies        (ids are lowercased)
#github-configuration              -> #edit-this-page-configuration
#option-2-namespace-based-versioning -> #combined-sdks-from-multiple-apis
navigation#add-a-product / #add-a-version -> /learn/docs/configuration/products, /versions (moved to own pages)

Two links pointed at options that don't exist on the target page (typescript/configuration#generatewiretests, ruby/configuration#package-name); those now link to the page without a fragment rather than to a wrong section.

AGENTS.md said <Step>/<Tab>/<Accordion> titles never get anchors. Production renders ids for them (and for <ParamField path> with toc={true}), so the section now describes what actually produces an id and how the id is derived, instead of telling writers to avoid them.

Once #6991 lands, its baseline can drop the 36 broken-anchor lines.

Link to Devin session: https://app.devin.ai/sessions/4b823dd919a841988f58f31b6dc722a2
Open in Devin Desktop: https://app.devin.ai/desktop/session/4b823dd919a841988f58f31b6dc722a2?variant=devin
Requested by: @emmanueletienne-blip


Devin Review

…in AGENTS.md

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

devin-ai-integration[bot]

This comment was marked as resolved.

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
| [Steps](/learn/docs/writing-content/components/steps) | Supported |
| [Tables](/learn/docs/writing-content/components/tables) | Supported |
| [Sticky tables](/learn/docs/writing-content/components/tables#sticky-tables) | Coming soon |
| [Sticky tables](/learn/docs/writing-content/components/tables#sticky-headers) | Coming soon |

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.

⚠️ [vale] <FernStyles.Current> reported by reviewdog 🐶
Avoid time-relative terms like 'soon' that become outdated

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