Fix heading levels and reorganize "Creating a workspace from code sample"

[themr0c]

• fix following errors when building the documentation

asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 25: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 56: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 66: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 70: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 84: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 117: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-by-importing-source-code-of-your-project.adoc: line 54: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-by-importing-source-code-of-your-project.adoc: line 67: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_creating-a-workspace-by-importing-source-code-of-your-project.adoc: line 78: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_configuring-a-che-workspace-using-a-devfile.adoc: line 20: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: proc_configuring-a-che-workspace-using-a-devfile.adoc: line 21: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-by-importing-source-code-of-your-project.adoc: line 55: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-by-importing-source-code-of-your-project.adoc: line 68: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-by-importing-source-code-of-your-project.adoc: line 79: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 26: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 57: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 67: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 71: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 85: section title out of sequence: expected level 1, got level 2
asciidoctor: WARNING: proc_creating-a-workspace-from-code-sample.adoc: line 118: section title out of sequence: expected level 1, got level 2

• Includes also additional work on "Configuring a che workspace using a devfile" and "Creating a workspace from code sample" to make them more compatible with modular content.

• Add an introduction on "Che quick starts" to have some target for links.

[rkratky]

@themr0c, in order to get {{site.baseurl}} to resolve in included files, they need to have :page-liquid: as the first line. Apologies for the confusion.

Please, update from master and apply this gimmick to your PR.

[rkratky]

@themr0c, this doesn't work. Can't be used.

Suggested change

url: che-7/che-quick-starts

[themr0c]

Given the fact that src/main/pages/che-7/overview/assembly_che-quick-starts.adoc has the necessary for that page to be generated, it works. And it would be very useful to point the user to a landing page for the quick starts.

[rkratky]

@themr0c what I mean is that when you click this menu item in the navig sidebar, it won't open the page, even though it will be built. (Navig items that expand to reveal other items can't open their own page.)

[rkratky]

@themr0c OK, I see now that you changed the navig structure, and the 'Che quick starts' item no longer expand -- instead, it opens its own page. Please, don't change thing like that without consulting it first.

[themr0c]

OK.

[rkratky]

Suggested change

	* A running instance of Eclipse Che. To install an instance of Eclipse Che see link:../che-quick-starts[Che quick-starts].
	* A running instance of Eclipse Che. To install an instance of Eclipse Che see link:{{site.baseurl}}/che-7/che-quick-starts[Che quick-starts].

[rkratky]

@themr0c, please, use the {{site.baseurl}} var for links. This relative inking isn't portable.

[rkratky]

Sorry, no, just {site-baseurl} -- an AsciiDoc attribute.

[themr0c]

Ack

[rkratky]

@themr0c, apologies, no {{site.baseurl}} and no :page-liquid: -- because of asciidoctor/jekyll-asciidoc#166, I had to resort to {site-baseurl} for paths. Defined in _config.yml and _config-war.yml.

[themr0c]

Hi @rkratky, the PR is rebased against current master.

Unfortunately, I didn't manage to get functional links with {site-baseurl}, so I ended up with ../ again.