Comment cleanups to improve generated docs

- added comments to fields which didn't have any.
- changed all `//` comments to the new format
- fixed indents/line lengths/style on lines I touched
You seem to have many good thoughts on comment improvements (vs I was just trying to fix the gross errors) so maybe do a pull request against main with any other cleanups you see?

I'm hoping this pull request (and some others) can go in quickly so that we can meet our end of month deadlines :)