docs: move troubleshooting guide to the generated CLI docs page

Brendan Lynchrequested to merge
bl-move-troubleshooting-to-docs into main

Description

Moves the invalid_client OAuth troubleshooting topic out of the README and into the generated CLI docs page (docs.gitlab.com/cli), so it lives on the canonical documentation site as the final content section before Report issues.

This is a follow-up to !3405 (merged), which originally added the topic inline in the README. This change:

  • Moves the troubleshooting topic to the generated docs page so it's discoverable on the canonical docs site.
  • Replaces the README Troubleshooting section with a link to that canonical section, instead of duplicating the content.
  • Adds a link to the GitLab CLI documentation style guide in the Contributing section.
  • Aligns the topic with the troubleshooting topic type guidance: severity-prefixed heading (Error:), a "you might encounter the following issues" intro, and "To resolve this issue" resolution wording.

Related issues and merge requests

Follow-up to !3405 (merged)

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

Edited by Brendan Lynch

Merge request reports