docs(repo): improve clone command documentation and examples

Kai Armstrongrequested to merge
improve-clone-git-flags-docs into main

Improves the glab repo clone command documentation by adding examples and rewriting descriptions to be more user-focused.

Changes

  • Add examples showing how to pass Git clone flags using the -- separator
  • Add examples for cloning specific branches and shallow clones
  • Rewrite Short and Long descriptions to emphasize user benefits
  • Remove redundant information

Context

Addresses the use case described in #8150 (closed) (adding a --branch flag) by documenting that users can already pass any Git flags using --, including --branch.

This approach avoids adding git-specific flags to glab, which would create maintenance burden and scope creep.

Merge request reports