diff --git a/modules/end-user-guide/pages/starting-a-new-workspace-with-a-clone-of-a-git-repository.adoc b/modules/end-user-guide/pages/starting-a-new-workspace-with-a-clone-of-a-git-repository.adoc index 0ea0fe294b..94bdedb2f6 100644 --- a/modules/end-user-guide/pages/starting-a-new-workspace-with-a-clone-of-a-git-repository.adoc +++ b/modules/end-user-guide/pages/starting-a-new-workspace-with-a-clone-of-a-git-repository.adoc @@ -35,6 +35,7 @@ To start a new workspace with a clone of a Git repository: . Optional: Visit your {prod-short} dashboard pages to authenticate to your organization's instance of {prod-short}. . Visit the URL to start a new workspace using the basic syntax: +.. Use a Git repository URL: [source,subs="+quotes,+attributes,+macros"] + ---- @@ -76,6 +77,32 @@ A clone of the Git repository is present in the filesystem of the new workspace. + The workspace has a unique URL: `pass:c,a,q[{prod-url}]#workspace____`. +.. Use a direct URL to `devfile`: +[source,subs="+quotes,+attributes,+macros"] ++ +---- +pass:c,a,q[{prod-url}]#____ +---- ++ +[TIP] +==== +You can pass Personal Access Token to the URL to have access to private repositories: +[source,subs="+quotes,+attributes,+macros"] +---- +pass:c,a,q[{prod-url}]#__https://____@____/__ <1> +---- +<1> See xref:using-a-git-provider-access-token.adoc[]. + +This works for GitHub, GitLab, Bitbucket, Microsoft Azure, and other providers that support Personal Access Token. +==== ++ +.A URL for starting a new workspace from devfile location +==== + +`pass:c,a,q[{prod-url}#https://raw.githubusercontent.com/che-samples/cpp-hello-world/main/devfile.yaml]` + +==== + [TIP] ==== Although this is not possible in the address bar, you can add a URL for starting a new workspace as a bookmark by using the browser bookmark manager: