Writing Documentation - JacquesCarette/Drasil GitHub Wiki
Warning: Wiki should not be edited directly. Edit the files in the ./wiki/ folder instead and make a PR.
As far as code comments go, one of the best resources is Best practices for writing code comments.
Also, be aware of the misuse of low information content phrases.