fix formatting
voice assumptions

This is better that letting the user face an error message and helps
those who do.
use reference-style links
link to an article, not to a blog
explain why this is a post-commit hook