Docs: add warnings to API operations that create non-trivial objects for user awareness
Doxygen: fix all the warnings in the doxygen system
Merge pull request #165 from broadinstitute/mc_api_docs_158

Developer documentation updates