docs: add synopsis and examples to misc standalone commands
Description
Resolves the remaining smaller standalone-page findings from the style guide audit in #8263 (closed), grouped into one MR.
- Adds a Synopsis to the
job,search,token, anduserparent commands. - Adds a Synopsis and Examples to
user eventsandversion. - Adds Examples to
completionandauth docker-helper. - The
searchcommand is in beta, so its Synopsis appends the standardtext.BetaStringnote.
Each Synopsis is additive and does not repeat the Short description.
The user parent help test was updated to match the rendered Synopsis
(Cobra renders Long in place of Short once Long is set).
Commands updated:
jobsearchtokenuseruser eventsversioncompletionauth docker-helper
Content follows the documentation style guide and the GitLab CLI (glab) documentation style guide.
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/.