Fix broken and fragile links in CHANGES.md#28977
Conversation
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
left a comment
There was a problem hiding this comment.
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).
| ----------------------------------------- | ||
| * 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) |
There was a problem hiding this comment.
Even better, I think this could be https://chapel-lang.org/docs/1.25/developer/bestPractices/StandardModuleStyle.html right?
| (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) |
There was a problem hiding this comment.
| (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) |
There was a problem hiding this comment.
| (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) |
There was a problem hiding this comment.
Update the following links in CHANGES.md:
mainunderhttps://github.com/chapel-lang/chapel/blob/main/-> link to blob on release branchhttps://chapel-lang/docs/->https://chapel-lang.org/docs/[reviewer info placeholder]
Testing:
brokfinds no broken links except historical URLs we want to keep