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
Yes, definitely! I'm traveling today, but will open a PR with the definitions tomorrow. Would you rather me open my PR against your PR (i.e., vs. this branch on your fork), or vs. the main repository?