document documenting the api. refs #640
Revise
Merge pull request #642 from mapbox/doc-docs

Some instructions for working locally with documentation