Reorganize docs to prepare automatic pdf doc build

[simone-weiss]

Changes

• Reorganize docs so that a pdf version can be generated with pandoc
• Add a script to build this pdf
• Add a gh action to build and upload a pdf as an asset on tag creation

Dependencies:

none

Tests results

n.a.

Developer Checklist:

• Test: Changes are tested
• Doc: Documentation has been updated
• Git: Informative git commit message(s)
• Issue: If a related GitHub issue exists, linking is done

Checklists for documentation

• Grammar: the content is grammatically correct
  (spelling, grammar, formatting, US English is used)
• Comprehensibility/Unambiguousness: the content is easy readable, clear to understand
• Correctness and consistency: the content is technically correct and consistent,
  no contradictions, no double descriptions
• Terminology: technical terms are clear and they are used correctly and documented in the glossary
• Level of detail: the content matches the detail level necessary for the reviewed object

Reviewer checklist:

• Review: Changes are reviewed
• Review: Tested by the reviewer

Checklists for documentation

• Grammar: the content is grammatically correct
  (spelling, grammar, formatting, US English is used)
• Comprehensibility/Unambiguousness: the content is easy readable, clear to understand
• Correctness and consistency: the content is technically correct and consistent,
  no contradictions, no double descriptions
• Terminology: technical terms are clear and they are used correctly and documented in the glossary
• Level of detail: the content matches the detail level necessary for the reviewed object

[simone-weiss]

EBcL_SDK.pdf
pdf created

[thir820]

@simone-weiss There is something broken with the $$RESULTS$$. It's rendered as a headline. Except this it looks good.

[simone-weiss]

@simone-weiss There is something broken with the R E S U L T S . It's rendered as a headline. Except this it looks good.

Fixed. I would suggest to add now a small script to generate that pdf and maybe run it always once we tag via an action?

[thir820]

@simone-weiss There is something broken with the R E S U L T S . It's rendered as a headline. Except this it looks good.

Fixed. I would suggest to add now a small script to generate that pdf and maybe run it always once we tag via an action?

+1