Skip to content

Verify ~ (tilde) links with MSDocs Verifier workflow - #37890

Merged
gewarren merged 3 commits into
mainfrom
gewarren-patch-2
Oct 17, 2026
Merged

gewarren merged 3 commits into
mainfrom
gewarren-patch-2

Conversation

@gewarren

@gewarren gewarren commented Oct 14, 2026 •

Copy link
Copy Markdown
Collaborator

Only exclude links that start with ~ if they point to a link in a different repo, in which case the pattern is ~/../. We should verify all other ~ links since this repo uses them extensively.


Internal previews

Toggle expand/collapse
File Preview link
aspnetcore/grpc/json-transcoding.md Learn preview
aspnetcore/grpc/json-transcoding/includes/json-transcoding7.md Learn preview
aspnetcore/includes/trustCertMac6.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-controller.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-controller/includes/adding-controller8.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-controller/includes/adding-controller9.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-model.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-model/includes/adding-model7.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-model/includes/adding-model8.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-model/includes/adding-model9.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-view.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-view/includes/adding-view8.md Learn preview
aspnetcore/tutorials/first-mvc-app/adding-view/includes/adding-view9.md Learn preview
aspnetcore/tutorials/first-mvc-app/controller-methods-views.md Learn preview
aspnetcore/tutorials/first-mvc-app/controller-methods-views/includes/controller-methods-views8.md Learn preview
aspnetcore/tutorials/first-mvc-app/controller-methods-views/includes/controller-methods-views9.md Learn preview
aspnetcore/tutorials/first-mvc-app/details.md Learn preview
aspnetcore/tutorials/first-mvc-app/details/includes/details8.md Learn preview
aspnetcore/tutorials/first-mvc-app/new-field.md Learn preview
aspnetcore/tutorials/first-mvc-app/new-field/includes/new-field8.md Learn preview
aspnetcore/tutorials/first-mvc-app/new-field/includes/new-field9.md Learn preview
aspnetcore/tutorials/first-mvc-app/search.md Learn preview
aspnetcore/tutorials/first-mvc-app/search/includes/search8.md Learn preview
aspnetcore/tutorials/first-mvc-app/search/includes/search9.md Learn preview
aspnetcore/tutorials/first-mvc-app/start-mvc/includes/start-mvc5.md Learn preview
aspnetcore/tutorials/first-mvc-app/start-mvc/includes/start-mvc6.md Learn preview
aspnetcore/tutorials/first-mvc-app/start-mvc/includes/start-mvc7.md Learn preview
aspnetcore/tutorials/first-mvc-app/start-mvc/includes/start-mvc8.md Learn preview
aspnetcore/tutorials/first-mvc-app/start-mvc/includes/start-mvc9.md Learn preview
aspnetcore/tutorials/first-mvc-app/validation.md Learn preview
aspnetcore/tutorials/first-mvc-app/validation/includes/validation8.md Learn preview
aspnetcore/tutorials/first-mvc-app/validation/includes/validation9.md Learn preview
aspnetcore/tutorials/first-mvc-app/working-with-sql.md Learn preview
aspnetcore/tutorials/first-mvc-app/working-with-sql/includes/working-with-sql3-5.md Learn preview
aspnetcore/tutorials/first-mvc-app/working-with-sql/includes/working-with-sql6.md Learn preview
aspnetcore/tutorials/first-mvc-app/working-with-sql/includes/working-with-sql7.md Learn preview
aspnetcore/tutorials/first-mvc-app/working-with-sql/includes/working-with-sql8.md Learn preview
aspnetcore/tutorials/first-mvc-app/working-with-sql/includes/working-with-sql9.md Learn preview
aspnetcore/tutorials/razor-pages/model/includes/model5.md Learn preview

Build report

Updated the excludeStartingWith list to include '~/../'.
Copilot AI balanced review requested due to automatic review settings October 14, 2026 23:24
@gewarren
gewarren requested a review from guardrex as a code owner October 14, 2026 23:24
@gewarren
gewarren enabled auto-merge (squash) October 14, 2026 23:25
@gewarren
gewarren marked this pull request as draft October 14, 2026 23:27
auto-merge was automatically disabled October 14, 2026 23:27

Pull request was converted to draft

@gewarren

Copy link
Copy Markdown
Collaborator Author

Looks like I need to fix the docs-verifier tool first.

Copilot AI 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.

🟡 Changes recommended

The pinned verifier resolves tilde-prefixed links against the repository root, causing valid docset-relative links to fail validation.

1 open finding
What changed in this PR

This PR narrows link-verifier exclusions to enable checking docset-relative links in ASP.NET Core documentation.

Changes:

  • Replaces the ~/ exclusion with ~/../, preserving exclusions for cross-repository links.
File Description
aspnetcore/​markdown-links-verifier-config.json Narrows the tilde-prefixed link exclusion.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@gewarren gewarren changed the title Modify markdown links verifier config Verify ~ (tilde) links with MSDocs Verifier workflow Oct 16, 2026
@gewarren
gewarren marked this pull request as ready for review October 16, 2026 01:42
@gewarren
gewarren merged commit d3e1885 into main Oct 17, 2026
7 checks passed
@gewarren
gewarren deleted the gewarren-patch-2 branch October 17, 2026 17:42
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.

3 participants