(doc) Update comment docs formatting

The docs team can now automatically extract comment docs from facts, but
that means that the comment docs have to be formatted just a bit more
consistently now. I've reformatted the ones that needed it. There are no
changes to actual code. There's some information about the formatting
standard I'm using in the README at github.com/holguinj/extracter