adjust docs formatting
whitespace adjustments
try linebreaks
better rules
smaller headings
bump / add newline
Re-generate
Merge pull request #372 from mapbox/fix-formatting

Fix formatting