Fix inconsistent doc headlines

fixes #132
Merge pull request #134 from mojotech/sjs/fix-132

Fix inconsistent doc headlines
Fix list docs