ore/gcloud: enhance comment re. `nolint` directive
It wasn't obvious from the comment what exactly was the issue. Enhance
it. Prep for having to do the same thing again lower down.
@@ -92,9 +92,12 @@ func runPromoteImage(cmd *cobra.Command, args []string) {
continue
}
// Some debug messages which are useful when needed.
- //nolint // Add nolint to pass golang-ci lint,
- // drop it when the error is gone, it's already fixed
- // see https://github.com/googleapis/google-api-go-client/issues/767
+ // This triggers the deprecation lint in golangci-lint because the
+ // docstring for the `Deprecated` field starts with "Deprecated: ". The
+ // docstring was tweaked to not trigger this, so we can drop this in the
+ // next vendor bump. See:
+ // https://github.com/googleapis/google-api-go-client/issues/767.
+ // nolint
if image.Deprecated != nil {
plog.Debugf("Deprecation state for %v is %v",
image.Name, image.Deprecated.State)
