* "Misc" use was disputed, moving back to use of the "Additional" category.
* Using a (link) pattern for URLs, reasons being:
* Including the markup into the outlines or hyperlinks considered a
bad practice and should be used carefully.
* The human cause:
The reason for the changelog is so people read through it and get the info.
Hyperlinks make text colored. Studies of readability have shown that
people perceive the information of a brightly colored text
much more poorly than the text of regular coloring.
And delivering the meaning is what changelog text is for, so the
informative text should be regularly colored.
* The technical cause -
the Hackage does not parse the markup inside the hyperlinks:
https://hackage.haskell.org/package/hnix-0.10.0/changelog
Probably because of the reason *1, but Hackage reason alone is enough.
* Since people perceive and think about the read information mostly linearly
and in the FIFO manner, `(link)` is put before information text, so links
are placed in the same space and look more uniform upon reading. And upon
reading the "link" context gets pushed first from the FIFO mind buffer and
the further understanding the text the person is not distracted by
sudden reading (taking-in) of the colored word "link" in the end of the
semantically challenging text that is required to be understood.
* Dependency requirements of last major versions made literal.
* Link to `(diff)` made more obvious. While professionals tend to look for the
link to the full diff, diff under version number is ambiguous to where the
version number link leads, it can be for example: a GitHub release (where
different forms of packages are provided), diff, commit listing (as it was before
the current change), official forum post, official news... etc.
* Made `(diff)` link to point directly towards the diff.
* Prepare release 0.9.2
* CHANGELOG: m upd to 0.9.{2,1}
* Update changelog and version
* CHANGELOG: m upd: unification of structure, forming 0.10.1
Breaking changes into "Breaking" section.
Miscellaneous changes into "Misc" section.
Co-authored-by: Simon Jakobi <simon.jakobi@gmail.com>
Anton-Latukha