spell out readme examples
typo and whitespace
style and names
Merge pull request #872 from rmosolgo/rm/metadocs

Spell out example in documentation readme