Skip to content

Fix broken and fragile links in CHANGES.md#28977

Open
arifthpe wants to merge 3 commits into
chapel-lang:mainfrom
arifthpe:changes-fix-links
Open

Fix broken and fragile links in CHANGES.md#28977
arifthpe wants to merge 3 commits into
chapel-lang:mainfrom
arifthpe:changes-fix-links

Conversation

@arifthpe

@arifthpe arifthpe commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

Update the following links in CHANGES.md:

  • link to blobs on main under https://github.com/chapel-lang/chapel/blob/main/ -> link to blob on release branch
    • many of these are broken
    • some are not broken, but could break in the future if we [re]move the referenced file, and in any case this is more faithful to what we referenced at time of writing
  • one instance of https://chapel-lang/docs/ -> https://chapel-lang.org/docs/
    • minor wording change to item to maintain line length limit

[reviewer info placeholder]

Testing:

  • brok finds no broken links except historical URLs we want to keep

arifthpe added 3 commits June 15, 2026 10:17
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>

@bradcray bradcray left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This looks great, thanks Anna! I don't think I've ever understood GitHub's blob/ paths well enough to have realized (consistently maybe) that this was an option.

Check my work, but I think I found a few blob-style URLs that could be made into true pointers to documentation, but only a few. Others either aren't part of the hierarchy that's rendered in the docs or pre-dated when we started rendering the developer/bestPractices content as part of the docs (or both).

Comment thread CHANGES.md
-----------------------------------------
* added a draft style guide for standard modules
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/StandardModuleStyle.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/StandardModuleStyle.rst)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Comment thread CHANGES.md
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/StandardModuleStyle.rst)
* added notes about how Chapel web documentation is built
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/buildingdocs.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/buildingdocs.rst)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Comment thread CHANGES.md
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/buildingdocs.rst)
* added information about how to test PRs in the contributor guidelines
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/ContributorInfo.rst#reviewer-responsibilities)
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/ContributorInfo.rst#reviewer-responsibilities)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Comment thread CHANGES.md
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/ContributorInfo.rst#reviewer-responsibilities)
* generally cleaned up and streamlined the contributor guidelines
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/ContributorInfo.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/bestPractices/ContributorInfo.rst)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants