Added sections on documenting and debugging, clarifications