Skip to content

Fix broken and fragile links in CHANGES.md #28977

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
arifthpe wants to merge 3 commits into
base: main
Choose a base branch
from
+31 −31
Open

Fix broken and fragile links in CHANGES.md #28977

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
da5dec0
Use release branch instead of main for Github blob links
arifthpe Jun 15, 2026
6d6a71c
Fix chapel-lang/docs/ -> chapel-lang.org/docs/
arifthpe Jun 15, 2026
7ede0ab
Reword item to respect line length limit
arifthpe Jun 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 31 additions & 31 deletions CHANGES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1589,7 +1589,7 @@ Runtime Library Improvements
Third-Party Software Changes
----------------------------
* added a bundled version of `mimalloc` 2.1.7 as a memory allocator option
(see https://github.com/chapel-lang/chapel/blob/main/third-party/mimalloc/README)
(see https://github.com/chapel-lang/chapel/blob/release/2.5/third-party/mimalloc/README)
* updated the bundled version of Qthreads to 1.22
* updated the bundled hwloc to version 2.11.2

Expand Down Expand Up @@ -6677,7 +6677,7 @@ Third-Party Software Changes
Developer-oriented changes: Process
-----------------------------------
* introduced a Code of Conduct for Chapel developers
(see https://github.com/chapel-lang/chapel/blob/main/CODE_OF_CONDUCT.md)
(see https://github.com/chapel-lang/chapel/blob/release/1.27/CODE_OF_CONDUCT.md)

Developer-oriented changes: Documentation
-----------------------------------------
Expand Down Expand Up @@ -7777,19 +7777,19 @@ Developer-oriented changes: Naming Changes
Developer-oriented changes: Documentation
-----------------------------------------
* 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)

@bradcray bradcray Jun 18, 2026

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.

Even better, I think this could be https://chapel-lang.org/docs/1.25/developer/bestPractices/StandardModuleStyle.html right?

* 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)

@bradcray bradcray Jun 18, 2026

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.

Similarly, https://chapel-lang.org/docs/1.25/developer/bestPractices/buildingdocs.html

* 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)

@bradcray bradcray Jun 18, 2026

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.

https://chapel-lang.org/docs/1.25/developer/bestPractices/ContributorInfo.html#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)

@bradcray bradcray Jun 18, 2026

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.

https://chapel-lang.org/docs/1.25/developer/bestPractices/ContributorInfo.html

* improved the layout of documentation generated for the new compiler
* moved documents in `compilerOverview/` to `implementation/compilerOverview/`
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/implementation/compilerOverview/)
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/implementation/compilerOverview/)
* documented the implementation of interfaces and a proposed new approach
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/implementation/Interfaces.md
and https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/implementation/Interfaces-new.md)
(see https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/implementation/Interfaces.md
and https://github.com/chapel-lang/chapel/blob/release/1.25/doc/rst/developer/implementation/Interfaces-new.md)

Developer-oriented changes: Module changes
------------------------------------------
Expand Down Expand Up @@ -7988,7 +7988,7 @@ New Features
(see https://chapel-lang.org/docs/1.24/language/spec/statements.html#the-conditional-statement
and https://chapel-lang.org/docs/1.24/language/spec/statements.html#the-while-do-and-do-while-loops)
* added initial support for constrained generic interfaces
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/chips/2.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.24/doc/rst/developer/chips/2.rst)
* added support for directly indexing `string` and `bytes` literals
(e.g., `var s = "Chapel"[0];` and `var b = b"is great!"[0];` now work)
* added `domain.orderToIndex(i)` to get the `i`th index in a rectangular domain
Expand Down Expand Up @@ -8238,17 +8238,17 @@ Third-Party Software Changes
Developer-oriented changes: Process
-----------------------------------
* switched from having developers sign CLAs to using DCO-based commits
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/DCO.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.24/doc/rst/developer/bestPractices/DCO.rst)

Developer-oriented changes: Documentation
-----------------------------------------
* updated the docs to reflect our use of Discourse rather than mailing lists
* refreshed the information in our 'GettingStarted' documentation
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/GettingStarted.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.24/doc/rst/developer/bestPractices/GettingStarted.rst)
* refactored our 'ContributorInfo' documentation w.r.t. DCOs, git tips, etc.
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/ContributorInfo.rst,
https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/DCO.rst,
and https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/git.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.24/doc/rst/developer/bestPractices/ContributorInfo.rst,
https://github.com/chapel-lang/chapel/blob/release/1.24/doc/rst/developer/bestPractices/DCO.rst,
and https://github.com/chapel-lang/chapel/blob/release/1.24/doc/rst/developer/bestPractices/git.rst)
* switched to a non-Cray version of the Chapel logo in the project's README
* created an improved and independently-maintained pygments highlighter
(see https://github.com/chapel-lang/sphinxcontrib-chapeldomain)
Expand Down Expand Up @@ -9787,7 +9787,7 @@ Launchers
Testing System
--------------
* added support for running multilocale C tests via `start_test`
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/TestSystem.rst#comparing-to-a-c-version)
(see https://github.com/chapel-lang/chapel/blob/release/1.20/doc/rst/developer/bestPractices/TestSystem.rst#comparing-to-a-c-version)

Developer-oriented changes: Module changes
------------------------------------------
Expand Down Expand Up @@ -10430,7 +10430,7 @@ Feature Improvements
(see 'Function Visibility in Generic Functions' in the 'Generics' chapter)
* made `in` arguments more consistent with variable initialization
(see 'Argument Intents' in the language specification's 'Procedures' chapter)
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/chips/13.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.18/doc/rst/developer/chips/13.rst)
* added support for casts from `c_void_ptr` to `c_ptr`

Removed Features
Expand Down Expand Up @@ -10764,10 +10764,10 @@ Developer-oriented changes: Compiler improvements/changes
Developer-oriented changes: Documentation improvements
------------------------------------------------------
* revamped the test system documentation to better serve new developers
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/TestSystem.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.18/doc/rst/developer/bestPractices/TestSystem.rst)
* added a `check_path` script to find bad filepath references in repository
* documented the launcher interface
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/adding-a-launcher.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.18/doc/rst/developer/adding-a-launcher.rst)
* removed `404 error` output after successful documentation build
* removed `git clean` suggestion after failed documentation build

Expand Down Expand Up @@ -10829,7 +10829,7 @@ Cray-specific Changes

Documentation
-------------
* simplified URLs to use https://chapel-lang/docs/ rather than .../docs/latest/
* changed URLs to use https://chapel-lang.org/docs/ rather than .../docs/latest/
* fixed some typos and broken links in this file

Packaging Changes
Expand Down Expand Up @@ -10904,7 +10904,7 @@ New Tools / Tool Changes
Semantic Changes / Changes to Chapel Language
---------------------------------------------
* `in` intents now behave more like variable initialization
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/chips/13.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.17/doc/rst/developer/chips/13.rst)
* ranges are now passed by `const in` intent by default
(see 'The Default Intent' in the 'Procedures' chapter of the specification)
* disallowed implicit coercions for type arguments with a formal type specifier
Expand Down Expand Up @@ -11281,12 +11281,12 @@ Developer-oriented changes: Compiler improvements/changes
Developer-oriented changes: Documentation improvements
------------------------------------------------------
* updated CONTRIBUTING.md content, to reduce redundancy with other docs
(see https://github.com/chapel-lang/chapel/blob/main/.github/CONTRIBUTING.md)
(see https://github.com/chapel-lang/chapel/blob/release/1.17/.github/CONTRIBUTING.md)
* updated GitHub issue template to request users to note blocking issues
(see https://github.com/chapel-lang/chapel/blob/main/.github/ISSUE_TEMPLATE.md)
(see https://github.com/chapel-lang/chapel/blob/release/1.17/.github/ISSUE_TEMPLATE.md)
* modified ContributorInfo.rst and TestSystem.rst for clarity
* document new future file format option
(see https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/bestPractices/TestSystem.rst#futures-a-mechanism-for-tracking-bugs-feature-requests-etc)
(see https://github.com/chapel-lang/chapel/blob/release/1.17/doc/rst/developer/bestPractices/TestSystem.rst#futures-a-mechanism-for-tracking-bugs-feature-requests-etc)

Developer-oriented changes: Module improvements
-----------------------------------------------
Expand Down Expand Up @@ -11785,13 +11785,13 @@ New Features
------------
* dramatically improved support for initializers
(see https://chapel-lang.org/docs/1.15/technotes/initializers.html
and https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/chips/10.rst)
and https://github.com/chapel-lang/chapel/blob/release/1.15/doc/rst/developer/chips/10.rst)
* added prototype support for error-handling in Chapel
(see https://chapel-lang.org/docs/1.15/technotes/errorHandling.html
and https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/chips/8.rst)
and https://github.com/chapel-lang/chapel/blob/release/1.15/doc/rst/developer/chips/8.rst)
* added support for deinit() as a replacement for class/record destructors
(see "Class Deinitializer" and "Record Deinitializer" sections in the spec
and https://github.com/chapel-lang/chapel/blob/main/doc/rst/developer/chips/10.rst)
and https://github.com/chapel-lang/chapel/blob/release/1.15/doc/rst/developer/chips/10.rst)
* added support for 'forwarding' methods to fields of classes and records
(see https://chapel-lang.org/docs/1.15/technotes/forwarding.html)
* made 'void' a first-class type in the language and a way to fold variables
Expand Down Expand Up @@ -11951,7 +11951,7 @@ Documentation
(see https://chapel-lang.org/docs/1.15/usingchapel/QUICKSTART.html)
* reorganized the doc/ directory in the release tarball
(see $CHPL_HOME/doc/README.md
or https://github.com/chapel-lang/chapel/blob/main/doc/README.rst)
or https://github.com/chapel-lang/chapel/blob/release/1.15/doc/README.rst)
* removed $CHPL_HOME/STATUS in favor of GitHub issues
* updated bugs.rst to refer users to GitHub issues
(see https://chapel-lang.org/docs/1.15/usingchapel/bugs.html)
Expand Down Expand Up @@ -12313,7 +12313,7 @@ New Features
* added the ability to create serial iterators for types
(see 'The Method Receiver and the 'this' Argument' in the language spec)
* added early prototype support for class/record initializers (constructors)
(see https://github.com/chapel-lang/chapel/blob/main/doc/chips/10.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.14/doc/chips/10.rst)

Feature Improvements
--------------------
Expand Down Expand Up @@ -13172,15 +13172,15 @@ Highlights
* significantly revamped and improved correctness and performance testing system
* improved how internal error messages are displayed to users
* added Chapel Improvement Proposals (CHIPs) framework for proposing changes
(see https://github.com/chapel-lang/chapel/blob/main/doc/chips/1.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.12/doc/chips/1.rst)
* made more bug fixes than any release since version 1.1
(see "Bug Fixes" section below)
* addressed portability issues for a number of platforms and compilers

Process Improvements
--------------------
* added Chapel Improvement Proposals (CHIPs) framework for proposed changes
(see https://github.com/chapel-lang/chapel/blob/main/doc/chips/1.rst)
(see https://github.com/chapel-lang/chapel/blob/release/1.12/doc/chips/1.rst)

Environment/Configuration Changes
---------------------------------
Expand Down