Updating comments to conform to golang comment specification

[caibirdme]

Motivation

Go's comment spec requires that the comment must start with the name it describes. Fix some comments to reduce IDE warnings

Modifications

• Make the comments start with the name of the element it describes

Verifying this change

• Make sure that the change passes the CI checks.

This change is a trivial rework / code cleanup without any test coverage.

Does this pull request potentially affect one of the following parts:

• Dependencies (does it add or upgrade a dependency): no
• The public API: no
• The schema: no
• The default values of configurations: no
• The wire protocol: no

[cckellogg]

Is there a way to add these comments format checks to the lint checks we do for ci?