[meta] add the "why" in commit body too

[goyalyashpal]

• add the "why" in commit body too: even 1-2 sentences will suffice.
• it will function as dod (defense of design) itself 😃 ; and hence will super reduce any nagging annoying questions
• also, don't ever post only links there, make sure the crux of the reasoning is understandable right there in the plain text commit body 😃
• this will also act as a last chance to think about if the change/design is good

https://github.com/uiua-lang/uiua/blob/eff92d4a3f6384ec4922901f588b276ce00a4598/site/src/other.rs#L17-L19

examples:

• https://github.com/uiua-lang/uiua/commit/81afa83d1c55e05b39033a60b6b9071e9d0f008d & https://github.com/uiua-lang/uiua/commit/a117396ac23d0807db14eaa42bf40e43db76e019: "change dip's glyph" (→ to ⊙) the arrow felt super apt: it moves the current position of the stack one position towards right for the next operation.
• https://github.com/uiua-lang/uiua/commit/07378ef652bc86a99f663a400f1856e4aa06adaf (#84): "formatting of ascii glyph functions"
• https://github.com/uiua-lang/uiua/commit/27bcc47a67b2b758e334ddd218a141b564ed8ed7 https://github.com/uiua-lang/uiua/commit/01df5573f74440d0b7fd18df612f8a35439f0667: "call it [share] lives" then reversion: "rename lives to share"

[iFreilicht]

The currently frequent changes are motivated by the attempt to make working with multiple values on the stack easier. The newest iteration, which is what you're seeing with dip here, is planet notation.

In general, the language evolves very quickly right now, and the docs are kept in sync to serve as the dod, but I don't have a strong opinion on this.

[kaikalii]

This is not how I use commits. I have been putting brief explanations in the changelogs.

[goyalyashpal]

in the changelogs

https://github.com/uiua-lang/uiua/blob/main/changelog.md

'kayh 👍

yeah, thats much much better

[goyalyashpal]

the downside of manual changelog is that its disconnected with commits (or would require more additonal efforts)

not to mention the chance of missing smth

---

if the commit had body,

then i suppose u could use commit-changelog to automatically generate the changelog from commits-body & just tweak it from there.

Refer:

• Changelog auto-generated by Release Changelog Builder Action (Mike Penz).
• Source: https://github.com/cyb3rko/pincredible/releases/tag/v0.5.0