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
Might be clearer as `The bases of the read sequence contained in this alignment record.` You might want to make a similar change for alignedQuality as well.