Review and update cli documentation for working with self managed instances
There has been some issues raised that indicate that using `glab` with self-managed instances is not straight-forward.
The purpose of this issue is to test out the current documentation and modify if there are inaccuracies or additions needed.
Some current relevant documentation: https://gitlab.com/gitlab-org/cli#authentication
Consider two use cases:
- A user who only uses their self-managed instance
- A user who uses gitlab.com AND uses their self-managed instance
Issue template changes:
Add additional checks for self-managed instances
- instruction for getting gitlab version
- check access token using api (if 401)
Related issues:
- [x] https://gitlab.com/gitlab-org/cli/-/issues/1229#note_1276612963 -> https://gitlab.com/gitlab-org/cli/-/merge_requests/1194
- [X] https://gitlab.com/gitlab-org/cli/-/issues/1235#note_1276725523 -> misleading error message that would can effect self-managed instances improved
- [x] Issue template improvements for self managed https://gitlab.com/gitlab-org/cli/-/merge_requests/1194
- [x] https://gitlab.com/gitlab-org/cli/-/issues/1248
- [ ] https://gitlab.com/gitlab-org/cli/-/issues/1220#note_1271200669
- [ ] https://gitlab.com/gitlab-org/cli/-/issues/1236
- [ ] https://gitlab.com/gitlab-org/cli/-/issues/1236#note_1290682842
- [ ] https://gitlab.com/gitlab-org/cli/-/issues/1073#note_1138892801 <- possibly needs to be added to documentation
- [x] https://gitlab.com/gitlab-org/cli/-/issues/1233#note_1298012856 <-confusing workflow for self-managed user -> I believe this is addressed in https://gitlab.com/gitlab-org/cli/-/merge_requests/1194
- [ ] https://gitlab.com/gitlab-org/cli/-/issues/1258 better error message
- [x] Add example config for self managed instance https://gitlab.com/gitlab-org/cli/-/merge_requests/1194
Issues raised to improve self-managed experience:
- https://gitlab.com/gitlab-org/cli/-/issues/1254
- https://gitlab.com/gitlab-org/cli/-/issues/1253
Note: may also need to consider OnePassword plugin if relevant
Context:
https://gitlab.com/gitlab-org/create-stage/-/issues/13117#note_1269146083
issue