docs: user onboarding, starting a new workspace, URL parameters

[max-cx]

What does this pull request change

This is the reworked master branch version of #2227.

What issues does this pull request fix or reference

Specify the version of the product this pull request applies to

Pull request checklist

The author and the reviewers validate the content of this pull request with the following checklist, in addition to the automated tests.

• Any procedure:
  • Successfully tested.
• Any page or link rename:
  • The page contains a redirection for the previous URL.
  • Propagate the URL change in:
    • Dashboard default branding data
    • Chectl constants.ts
• Builds on Eclipse Che hosted by Red Hat.
• the Validate language on files added or modified step reports no vale warnings.

[github-actions]

Click here to review and test in web IDE:

[max-cx]

@benoitf, i'm sorry about your disappointment.

This image can only be added to the docs as an example because it contains a specific repository and a unique choice of optional parameters.

To use the image in the docs, we would need to replace che-host with a real-life URL to make the example consistent and complete.
Then, we'd probably need to make a downstream version of the image and use a different font as well to make it in line with the downstream docs.
On the one hand, I wouldn't want to bother you with editing this image when I needed this to be done.
On the other hand, I myself don't perceive the advantages of using an image here and making the editing effort.
Also, if there are any future changes on this topic, any contributor to the docs repo can quickly and easily update the adoc files without having to discard the image or figure out how to edit the image or produce a new one.

I really appreciate your effort that you put into the blog post, but I'd also like to avoid the complications of using images in the docs where images may not be irreplaceable like in this particular context.

[benoitf]

@max-cx the image is generated using that link https://excalidraw.com/#json=Z4gT6H3GoZwJkfvVCajad,Qtltwy9uKpQOtosF8mh00g

so no need to bother people, it's easy to update :-)

[max-cx]

@benoitf, I like it, thanks for sharing!

I've tried it. See for yourself, the URL is too long for an image when used in the docs.
So the letters become too small even before adding a real-world hostname, which will make it even longer and smaller:

Compare it to what I have now:

[rkratky]

@max-cx, review with a few changes submitted.

[themr0c]

I apologize for the erroneous closing. My mistake.

[max-cx]

@max-cx, review with a few changes submitted.

@rkratky, I revised it in response to your suggestions.

Starting a new workspace with a clone of a Git repository Eclipse Che Documentation.pdf

Optional parameters for the URLs for starting a new workspace Eclipse Che Documentation.pdf

Basic actions you can perform on a workspace Eclipse Che Documentation.pdf