As discussed in a recent [PR][1], people should treat their
changelogs as canonical sources given their portability.
Release posts can easily be created manually or automatically
since the Keep a Changelog format is easy to parse for both
humans and machines.
[1]: https://github.com/olivierlacan/keep-a-changelog/pull/629#issuecomment-2766514005
Previously they had to be duplicated from the page
frontmatter but that's not necessary and also makes
it possible to have correct OpenGraph title and
descriptions.
This will remove a lot of redundant variable definitions from
Haml translations and centralize everything so it's much easier to
update links when the invariably change. As they have.
We don't quite yet want to redirect to this version although it will be
good to be able to test it.
# Title
# Tell me everything!
# Co-authors (they will be credited on GitHub as well)
# Co-authored-by: Carolina Powers <carolinapoloni@gmail.com>
# Co-authored-by: Meg Kline-Tuls <meglktuls@gmail.com>
# Co-authored-by: Will <will-soto@pluralsight.com>
# Co-authored-by: thatchej <jaron-thatcher@pluralsight.com>
This section was by far the weakest since it focused too heavily on
issues with the U.S.-based date formats and not enough on justifying
the recommendation.
Addresses #191#178
It’s time.
Reworked sections and extracted out-of-band information
into a frequently asked questions section as a sort of catch all
to keep everything focused.
Gave up Markdown since it seriously limits our styling possibilities
while Haml doesn’t hurt the legibility or the barrier to entry much.
Only part I don’t love yet are the reference links that are now up
top in the source file.