refactor(docs-infra): validate api/cdk and api/aria links by erkamyaman · Pull Request #70586 · angular/angular · GitHub
Skip to content

refactor(docs-infra): validate api/cdk and api/aria links - #70586

Open
erkamyaman wants to merge 1 commit into
angular:mainfrom
erkamyaman:drop-stale-api-link-validation-exemptions
Open

refactor(docs-infra): validate api/cdk and api/aria links#70586
erkamyaman wants to merge 1 commit into
angular:mainfrom
erkamyaman:drop-stale-api-link-validation-exemptions

Conversation

@erkamyaman

Copy link
Copy Markdown
Contributor

isKnownRoute exempted both families behind TODOs waiting on route extraction for those packages. That extraction had already landed when the TODOs were written in #66254: cdk pages since #60853 and aria pages since the cross-repo workflow. defined-routes.json carries 70 api/cdk and 39 api/aria routes today, and all 45 such link targets in the guides resolve, so the build stays green without the exemptions.

The gap was not theoretical. guide/aria/select.md and guide/aria/multiselect.md linked api/cdk/overlay/CdkConnectedOverlay, which has never been a route, and it shipped as a 404 for six months. Link validation landed four months into that and said nothing, because of this exemption. It took a user filing #68914 and an outside contributor fixing it in #68915.

`isKnownRoute` exempted both families behind TODOs waiting on route extraction
for those packages. That extraction had already landed when the TODOs were
written in angular#66254: cdk pages since angular#60853 and aria pages since the cross-repo
workflow. `defined-routes.json` carries 70 `api/cdk` and 39 `api/aria` routes
today, and all 45 such link targets in the guides resolve, so the build stays
green without the exemptions.

The gap was not theoretical. `guide/aria/select.md` and
`guide/aria/multiselect.md` linked `api/cdk/overlay/CdkConnectedOverlay`, which
has never been a route, and it shipped as a 404 for six months. Link validation
landed four months into that and said nothing, because of this exemption. It
took a user filing angular#68914 and an outside contributor fixing it in angular#68915.

Pointing an existing `api/cdk` link at a symbol that does not exist passes the
build today and fails it with this change.
@pullapprove
pullapprove Bot requested a review from kirjs September 5, 2026 22:16
@angular-robot angular-robot Bot added the area: docs-infra Angular.dev application and infrastructure label Sep 5, 2026
@ngbot ngbot Bot added this to the Backlog milestone Sep 5, 2026
@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 Sep 6, 2026
@JeanMeche
JeanMeche removed the request for review from kirjs September 6, 2026 11:13
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 area: docs-infra Angular.dev application and infrastructure target: patch This PR is targeted for the next patch release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants