Skip to content

Comments

fix(docs-infra): use shared heading ID generation logic#67201

Merged
thePunderWoman merged 1 commit intoangular:mainfrom
lacolaco:fix/docs-infra/heading-id
Feb 23, 2026
Merged

fix(docs-infra): use shared heading ID generation logic#67201
thePunderWoman merged 1 commit intoangular:mainfrom
lacolaco:fix/docs-infra/heading-id

Conversation

@lacolaco
Copy link
Contributor

PR Checklist

Please check if your PR fulfills the following requirements:

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • CI related changes
  • Documentation content changes
  • angular.dev application / infrastructure changes
  • Other... Please describe:

What is the current behavior?

The route generation script (generate-routes.mts) ignores custom heading IDs ({#id}) and generates routes based on the heading text only. This is inconsistent with the markdown pipeline (heading.mts), which respects custom IDs.

Issue Number: #67200

What is the new behavior?

The logic for generating heading IDs has been extracted into a shared utility (adev/shared-docs/pipeline/shared/heading.mts). Both generate-routes.mts and heading.mts now use this shared logic, ensuring consistent behavior. Custom IDs are now correctly respected in generated routes.

Does this PR introduce a breaking change?

  • Yes
  • No

Other information

@pullapprove pullapprove bot requested a review from bencodezen February 23, 2026 05:29
@angular-robot angular-robot bot added the area: docs-infra Angular.dev application and infrastructure label Feb 23, 2026
@ngbot ngbot bot added this to the Backlog milestone Feb 23, 2026
This commit extracts the heading ID generation logic into a shared utility
and updates both the route generation script and the markdown pipeline to use it.

This ensures consistency between the generated routes and the rendered
documentation, and fixes an issue where custom heading IDs (`{#id}`)
were ignored during route generation.

Fixes angular#67200
@JeanMeche JeanMeche force-pushed the fix/docs-infra/heading-id branch from 33394a0 to e824be2 Compare February 23, 2026 21:19
Copy link
Member

@JeanMeche JeanMeche left a comment

Choose a reason for hiding this comment

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

Thanks for the cleanup Suguru ! Much appreciated 🙂

@JeanMeche JeanMeche added action: merge The PR is ready for merge by the caretaker target: patch This PR is targeted for the next patch release labels Feb 23, 2026
@JeanMeche JeanMeche removed the request for review from bencodezen February 23, 2026 22:26
@thePunderWoman thePunderWoman added target: rc This PR is targeted for the next release-candidate and removed target: patch This PR is targeted for the next patch release labels Feb 23, 2026
@thePunderWoman
Copy link
Contributor

This has conflicts with patch. So I've switched it to target: rc.

@thePunderWoman thePunderWoman merged commit bedfcb5 into angular:main Feb 23, 2026
23 of 24 checks passed
@thePunderWoman
Copy link
Contributor

This PR was merged into the repository. The changes were merged into the following branches:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action: merge The PR is ready for merge by the caretaker adev: preview area: docs-infra Angular.dev application and infrastructure target: rc This PR is targeted for the next release-candidate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants