Docs: formatting, typo fixes
Encourage specifying the package name and Git URL
Markdown 'api' in package-source.js