Minor readme fixes

Improvements to the markdown and updates now that osm-carto is the standard
Move documentation for contributors to CONTRIBUTING
Merge pull request #723 from pnorman/docs

Split off docs for contributors