Sometimes a comment in code is just to persuade future readers that what you've done will work as intended.
miniblog.
Related Posts
Users are increasingly cynical of "only N still available" messages trying to persuade you to buy:
Other programmers using your code is often a high compliment.
Making something from scratch is fun, but learning someone else's API is work.
Rather than the common "I built one, you should use it", I try to ask "what would persuade you to use this?".
Turns out that patching Emacs' library loading whilst silencing user feedback can lead to some really interesting bugs: https://github.com/cask/shut-up/pull/12/commits/2495e8bf3d424f88f82679dd94def6b87960c4a9
This might be the longest commit message I've ever written. I think a good message tries to persuade the maintainer to accept the PR.
