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
Right now, the default value of this field in the schema is null. Should we assume that the majority of records will have a reference sequence? This might mean that we should change the default value to 0L.