fix typo
make uniform title underlines
fix missing periods in short descriptions
fix missing newline
Merge pull request #51 from esc/fix_readme

minor fixes to the readme