Developers:
Friend to friend: When you make a release please take a few minutes to make a human-readable changelog of what has changed since the last release?
Your commit-messages are not a changelog.
Let me re-iterate:
Your commit-messages are _not_ a changelog.
A changelog allows me to follow what you were thinking between releases.
A commit log shows me your keystrokes between releases.
I need to know what you were thinking.
Thank you.
@craigmaloney @zigg Oh, heck yes. You can't automate documentation. Not changelogs, not API definitions, not function descriptions. People should stop trying to get out of writing with tooling and take the time to communicate well.
Maybe writing wouldn't be so hard for developers if they bothered to take a few English classes?
@andrewt @craigmaloney @zigg I'm not expecting Pulitzer-prize winning prose from developers. I just want to read a changelog without this clip playing in the back of my head.
@starbreaker @andrewt @craigmaloney @zigg Depends on the classes; I don't mind broken syntax too much if the ideas are presented in a reasonable order and things are named clearly. Getting hung up on grammar is where we get code that's linted to heck but doesn't work.