lint + more explanation

hack/versions/pkg/schema/comment.go

@@ -30,9 +30,12 @@ import (
 const releasedComment = `// !!! WARNING !!! This config version is already released, please DO NOT MODIFY the structs in this file.`
 const unreleasedComment = `// This config version is not yet released, it is SAFE TO MODIFY the structs in this file.`
 
-// historicalVersionComments is used to recognize that this comment is a release comment 
-// if you want to change a comment historically on all files, add the current version here and then change the 
-// text of releasedComment and unreleasedComment, and then run `go run hack/versions/cmd/update_comments/main.go`
+// historicalVersionComments is used to recognize whether an existing comment is a "release comment" or not.
+// If you want to change a (say releasedComment) comment historically on all files, then:
+// 1.) add the current version to `historicalVersionComments`
+// 2.) change the text of releasedComment (or unreleasedComment)
+// 3.) run `go run hack/versions/cmd/update_comments/main.go`
+// 4.) remove the updated version from `historicalVersionComments`
 var historicalVersionComments = []string{
 	releasedComment,
 	unreleasedComment,