Add comments in several hack/verify-*.sh(s-v)

hack/verify-shellcheck.sh

@@ -14,6 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script lints each shell script by `shellcheck`.
+# Usage: `hack/verify-shellcheck.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-spelling.sh

@@ -15,7 +15,7 @@
 
 # This script checks commonly misspelled English words in all files in the
 # working directory by client9/misspell package.
-# Usage: hack/verify-spelling.sh
+# Usage: `hack/verify-spelling.sh`.
 
 set -o errexit
 set -o nounset

hack/verify-staging-meta-files.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script checks whether the expected metadata files (such as OWNERS and
+# LICENSE) exist under the `staging/src/k8s.io/*` directories.
+# Usage: `hack/verify-staging-meta-files.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-staticcheck.sh

@@ -14,6 +14,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script lints each package by `staticcheck`.
+# Usage: `hack/verify-staticcheck.sh`.
+# NOTE: To ignore issues detected a package, add it to the
+# `.staticcheck_failures` blacklist.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-test-code.sh

@@ -13,6 +13,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script checks whether e2e test code which contains `Expect()` but not use
+# the e2e framework exists or not.
+# Usage: `hack/verify-test-code.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-test-featuregates.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script checks whether mutable global feature gate is invocated correctly
+# in `*_test.go` files.
+# Usage: `hack/verify-test-featuregates.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-test-images.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script checks whether the latest or untagged  gcr.io image is in
+# `test/e2e/*.go` files.
+# Usage: `hack/verify-test-images.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-typecheck-providerless.sh

@@ -14,6 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script verifies the build without in-tree cloud providers.
+# Usage: `hack/verify-typecheck-providerless.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-typecheck.sh

@@ -14,6 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script does a fast type check of kubernetes code for all platforms.
+# Usage: `hack/verify-typecheck.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-vendor-licenses.sh

@@ -14,6 +14,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script checks whether updating of vendor licenses file is needed
+# or not. We should run `hack/update-vendor-licenses.sh` and commit the results,
+# if actually updates them.
+# Usage: `hack/verify-vendor-licenses.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail

hack/verify-vendor.sh

@@ -14,6 +14,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# This script checks whether fixing of vendor directory or go.mod is needed or
+# not. We should run `hack/update-vendor.sh` if actually fixes them.
+# Usage: `hack/verify-vendor.sh`.
+
 set -o errexit
 set -o nounset
 set -o pipefail