docs: improve help text for glab cluster commands
Description
Improves the help text across all glab cluster commands and subcommands for
consistency, clarity, and accuracy. Changes follow the GitLab CLI documentation
style guide.
Changes
- New
Longdescriptions added to parent commands (cluster,agent,token,token-cache) so that--helpoutput provides useful context rather than falling back to theShortdescription. Shortdescriptions updated to use imperative mood and end with a period, consistent with the style guide.Longdescriptions** rewritten across subcommands to add distinct value beyond whatShortalready says, remove markdown headers and lists that render as raw text in the terminal, and fix inaccuracies.- Flag descriptions updated across
graph,update-kubeconfig,check-manifest-usage, andbootstrapto use single quotes for inline code references, end with a period, and remove redundant(default false)annotations. Examplefields added toagent list,token list,token revoke,token-cache clear, andtoken-cache list, which previously had none. Thegraphexamples are inlined from the deletedexample.mdfile.
Related issues and merge requests
Documentation
If this MR adds or updates CLI command documentation, follow the conventions in the
GitLab CLI (glab) documentation style guide,
run make gen-docs, and commit the updated files in docs/source/.