Added sections on documenting and debugging, clarifications
Merge pull request #3777 from edx/ahodges/documentation/AN1031

Clarifications, added info on doc, format