docs: improve glab auth commands docs

Brendan Lynchrequested to merge
8263-improve-glab-auth-commands-docs into main

Description

This merge request improves the documentation for the GitLab CLI authentication commands by making the language clearer and more consistent. The changes include:

  • Rewrote command descriptions to be more user-friendly and actionable.
  • Added detailed explanations of what each command does and when to use it.
  • Included practical examples showing common usage patterns for logging in, configuring Docker integration, and generating authentication tokens.
  • Standardized the formatting and tone across all authentication-related documentation.
  • Enhanced the DPoP (security token) command documentation with clearer prerequisites and step-by-step guidance.
  • Added synopsis sections that explain the purpose and behavior of each command in plain language.

Related issues and merge requests

docs: Fix CLI documentation inconsistencies ide... (#8263)

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