The jekyll-relative-links plugin converts .md links to clean URLs (e.g.,
`FAQ.md` to `/FAQ`), which works for all links in `index.md` except
`C++-Standard-Libraries.md`. The issue is that the plugin assumes that
the link is escaped with `CGI.escape`, and calls `CGI.unescape` to try
to reverse the escaping. The plus signs `+` are unescaped to space
characters, so the unescaped link matches nothing, and the link is left
unconverted.
Fix that by escaping the plus signs in the link, which allows the plugin
to convert the link as expected.
Fixes#22102.
- At the AGM we formed an ad-hoc documentation working group.
- One of our ideas was that we should have a last reviewed date for
documentation, so that we can periodically implement a review
mechanism (GitHub Actions posts to Slack for a regular documentation
outdatedness check?) to track how old docs are and ensure they're
still relevant.
- This is a first step towards that goal, by adding a `last_review_date`
to the metadata of all docs with a date of earlier than Homebrew's
inception because everything needs reviewing so that we start from a
good base!
Patrick Linnane