Fix broken links in documentation using repository-root-relative paths#32338
Merged
jfversluis merged 3 commits intomainfrom Nov 3, 2025
Merged
Fix broken links in documentation using repository-root-relative paths#32338jfversluis merged 3 commits intomainfrom
jfversluis merged 3 commits intomainfrom
Conversation
…aths Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Fix broken links in CONTRIBUTING.md file
Fix broken links in CONTRIBUTING.md using repository-root-relative paths
Nov 2, 2025
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR updates relative file paths in the CONTRIBUTING.md file to use absolute paths from the repository root, making the links work correctly from any location in the repository.
Key changes:
- Updated markdown links to use absolute paths (starting with
/) instead of relative paths - Ensures links to CODE_OF_CONDUCT.md, DEVELOPMENT.md, PULL_REQUEST_TEMPLATE.md, and the Benchmarks directory work consistently
Member
|
@copilot can you review all of our docs (any markdown file) and validate that the links are correct? Please fix any links that are incorrect |
Co-authored-by: PureWeen <5375137+PureWeen@users.noreply.github.com>
Contributor
Author
I've completed a comprehensive review of all 52 markdown files in the repository. Broken links found and fixed:
Broken links found but NOT fixed:
All repository-owned documentation now has valid links. Fixed in commit 3694e78. |
Copilot
AI
changed the title
Fix broken links in CONTRIBUTING.md using repository-root-relative paths
Fix broken links in documentation using repository-root-relative paths
Nov 2, 2025
Contributor
|
/azp run |
|
Azure Pipelines could not run because the pipeline triggers exclude this branch/path. |
jsuarezruiz
approved these changes
Nov 3, 2025
jfversluis
approved these changes
Nov 3, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Links in
.github/CONTRIBUTING.mdand other documentation files used simple relative paths that fail to resolve correctly in certain GitHub rendering contexts (e.g., when displayed via the repository's "Contributing guidelines" feature).Changes
After comprehensive validation of all 52 markdown files in the repository, updated broken internal links to use repository-root-relative paths (prefixed with
/):.github/CONTRIBUTING.md
CODE_OF_CONDUCT.md→/.github/CODE_OF_CONDUCT.mdDEVELOPMENT.md→/.github/DEVELOPMENT.mdPULL_REQUEST_TEMPLATE.md→/.github/PULL_REQUEST_TEMPLATE.md(2 instances)../src/Core/tests/Benchmarks/→/src/Core/tests/Benchmarks/.github/copilot-instructions.md
.github/DEVELOPMENT.md→/.github/DEVELOPMENT.mddocs/DevelopmentTips.md→/docs/DevelopmentTips.md.github/CONTRIBUTING.md→/.github/CONTRIBUTING.mddocs/README.md
BuildFromSource.md→/.github/DEVELOPMENT.md(file was renamed/moved)This ensures links resolve correctly regardless of rendering context while maintaining the same target files. All repository-owned documentation now has validated, working links.
Validation
eng/common/template-guidance.mdwhich is managed by Arcade automation)Fixes #32336
Original prompt
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.