Documentation about Git repositories URLs is not complete

[l0rd]

Describe the bug

• Article "Authenticating to a Git server from a workspace" is missing the SSH key option for GIT + SSH URLs. Note that the SSH keys configuration is documented in DevWorkspace doc.

• Article "Starting a new workspace with a clone of a Git repository" doesn't mention that:

  • Starting a workspace using an HTTPS URL from a Git service other than GH, GL, BB, ADO will fail
  • When it's not possible to use HTTPS user can use GIT + SSH URLs (with their limit: the devfile is not resolved but there is a workaround for public repo and another for private repos)
  • Azure DevOps is supported too (branch and everything else)

• And the same article has also some other things to review:

  • GitHub and GitLab share the same samples? Really? Also for merge requests?
  • The workspace URL is wrong / not up to date
  • There is an unnecessary documentation how to add bookmarks in FF and Chrome
  • The initial paragraph, where all URLs are defined...Isn't that too complicated for an icebreaker?

• Article "Starting a new workspace from a devfile URL" should warn what we lose when using a raw Devfile URL:

  • the devfile needs to have the repo and branch hardcoded (i.e. you can't use it in a different fork or branch)
  • the devfile needs to be in a public repository
  • OAuth flow that automate git credential injection is not support (users needs to manually create credentials/SSH secrets)

Che version

7.70@latest