DOC : silence formatting warnings
DOC : fix mark-up
DOC/BLD : build docs from source

 - build the docs from the source, not installed code
 - add mocks so external dependencies don't need to be installed
DEV : added auto-generated doc files to gitignore
DOC : added calibration to api TOC
DOC : re-did core documentation
DOC/MNT : moved RCParamsDict to core
Merge pull request #160 from tacaswell/doc_work

Doc work