docs(repo): add synopsis and fix usage notation in repo commands

Brendan Lynchrequested to merge
8263-add-synopsis-and-examples-to-repo-commands into main

Description

Resolves the repo family findings from the style guide audit in #8263 (closed).

  • Adds a Synopsis to the repo parent command and to repo contributors, repo list, repo search, repo transfer, and repo update.
  • Fixes the repo mirror usage line to use the style guide's positional-argument notation: [ID | URL | PATH] → [<id | url | path>].

Each Synopsis is additive and does not repeat the Short description.

Commands updated:

  • repo
  • repo contributors
  • repo list
  • repo search
  • repo transfer
  • repo update
  • repo mirror

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/.

Merge request reports