chore(changelog): show full commit message

[joshka]

This allows someone reading the changelog to search for information
about breaking changes or implementation of new functionality.

• refactored the commit template part to a macro instead of repeating it
• added a link to the commit and to the release
• updated the current changelog for the alpha and unreleased changes
• Automatically changed the existing * lists to - lists

---

[codecov]

Codecov Report

Merging #423 (3e752c4) into main (6153371) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #423   +/-   ##
=======================================
  Coverage   86.41%   86.41%           
=======================================
  Files          40       40           
  Lines        9432     9432           
=======================================
  Hits         8151     8151           
  Misses       1281     1281           

[joshka]

This is in addition to sometime making a BREAKING_CHANGES.md, not a replacement for that idea.

[kdheepak]

I personally like this change, but I'm also curious if others have opinions on whether it is too verbose or not for a changelog.

[joshka]

I personally like this change, but I'm also curious if others have opinions on whether it is too verbose or not for a changelog.

I gave that a bit of consideration.

• The pro side is that more details = easier to search for information using Ctrl/Cmd+F. Finding what changed in a git commit history is often more difficult compared to searching a single file like this.
• The cons are that having too many details can get in the way of seeing the high level view of things overview.

I think the tradeoff is reasonable, but there's also a third approach we could have that moves the details to another section under the list of changes. It's a bit more work though.

[joshka]

P.s. Don't merge this just yet - letting @orhun take some time to look at some git cliff stuff before we do that.

[orhun]

I just tested this and liked the changelog output. I agree with @joshka's comments about tradeoff.

Also, using a macro is a nice refactor 💯 Applied it in git-cliff's changelog.