Are there standard formats for comments within code? [closed]

Answer 1

There are packages that will help write and format documentation. They require some specific changes so they can identify classes of comments.

such as doxygen:

http://www.doxygen.nl/manual/docblocks.html

/*! \brief Brief description.
 *         Brief description continued.
 *
 *  Detailed description starts here.
 */