lint

docs: Add Cobra docs generator and CI to ensure they remain up to date #3292

	# Copyright 2022 Google LLC
	#
	# Licensed under the Apache License, Version 2.0 (the "License");
	# you may not use this file except in compliance with the License.
	# You may obtain a copy of the License at
	#
	# http://www.apache.org/licenses/LICENSE-2.0
	#
	# Unless required by applicable law or agreed to in writing, software
	# distributed under the License is distributed on an "AS IS" BASIS,
	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	# See the License for the specific language governing permissions and
	# limitations under the License.

	name: lint
	on:
	pull_request:

	# Declare default permissions as read only.
	permissions: read-all

	jobs:
	lint:
	name: run lint
	runs-on: ubuntu-latest
	steps:
	- name: Setup Go
	uses: actions/setup-go@41dfa10bad2bb2ae585af6ee5bb4d7d973ad74ed # v5.1.0
	with:
	go-version: "1.23"
	- name: Checkout code
	uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
	- name: >
	Verify go mod tidy. If you're reading this and the check has
	failed, run `goimports -w . && go mod tidy && golangci-lint run`
	run: \|
	go mod tidy && git diff --exit-code
	- name: golangci-lint
	uses: golangci/golangci-lint-action@971e284b6050e8a5849b72094c50ab08da042db8 # v6.1.1
	with:
	version: latest
	args: --timeout 3m

Provide feedback