docsgen:

[jkowalleck]

context

current docsgen produce the following structure:

XML-SCHEMA-DOCUMENTATION
+---1.0
|       index.html
|
+---1.1
|       index.html
|
+---1.2
|       index.html
|
+---1.3
|       index.html
|
+---1.4
|       index.html
|
+---1.5
|       index.html
|
\---1.6
        index.html

but for the website we need it in the following format:

.../public/docs
+---1.0
|   \---xml
|           index.html
|
+---1.1
|   \---xml
|           index.html
|
+---1.2
|   +---json
|   |       index.html
|   |       schema_doc.css
|   |       schema_doc.min.js
|   |
|   \---xml
|           index.html
|
+---1.3
|   +---json
|   |       index.html
|   |       schema_doc.css
|   |       schema_doc.min.js
|   |
|   \---xml
|           index.html
|
+---1.4
|   +---json
|   |       index.html
|   |       schema_doc.css
|   |       schema_doc.min.js
|   |
|   \---xml
|           index.html
|
+---1.5
|   +---json
|   |       index.html
|   |       schema_doc.css
|   |       schema_doc.min.js
|   |
|   \---xml
|           index.html
|
\---1.6
    +---json
    |       index.html
    |       schema_doc.css
    |       schema_doc.min.js
    |
    \---xml
            index.html

issue

Since the structures from docgen and the website are not similar, it is simply impossible to copy the one into the other right away ...
Each folder needs to be copied separately and into another different folder. This is tedious and error-prone.

goal

This ticket's goal is to make the resulting structure from the docsgen more copy/past-friendly for the website.

At best, i can download the docgen artifacts and copy-paste tem directly into .../public/docs and be good to go.

expected outcome

docsgen produce the following structure:

some-SCHEMA-DOCUMENTATION
+---1.1
|   +---json || xml || proto
|       some-files
=
|
\---1.6
    +---json || xml || proto
            some-files