devonfw / devon4j

devonfw Java stack - create enterprise-grade business apps in Java safe and fast
Apache License 2.0
83 stars 87 forks source link

#420: moved universal sections to general #425

Closed hohwille closed 3 years ago

hohwille commented 3 years ago

moved universal sections to general for issue #420

hohwille commented 3 years ago
[INFO] asciidoctor: WARN: guide-component.asciidoc: line 5: section title out of sequence: expected level 2, got level 3
[INFO] asciidoctor: WARN: guide-structure-classic.asciidoc: line 5: section title out of sequence: expected level 2, got level 3
[INFO] asciidoctor: WARN: guide-structure-modern.asciidoc: line 5: section title out of sequence: expected level 2, got level 3
[INFO] asciidoctor: WARN: guide-domain-layer.asciidoc: line 5: section title out of sequence: expected level 2, got level 3
[INFO] asciidoctor: WARN: devon4j.asciidoc: line 272: id assigned to section already in use: devon4j.asciidoc_guides
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 5: id assigned to section already in use: guide-logging.asciidoc
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 20: id assigned to section already in use: guide-logging.asciidoc_usage
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 23: id assigned to section already in use: guide-logging.asciidoc_maven-integration
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 42: id assigned to section already in use: guide-logging.asciidoc_logger-access
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 69: id assigned to section already in use: guide-logging.asciidoc_configuration
[INFO] asciidoctor: WARN: quarkus/guide-cors-support.asciidoc: line 5: id assigned to section already in use: guide-cors-support.asciidoc
[INFO] asciidoctor: WARN: quarkus/guide-cors-support.asciidoc: line 20: id assigned to section already in use: guide-cors-support.asciidoc_configuring-cors-support
[INFO] Rendered /home/runner/work/devon4j/devon4j/documentation/target/asciidoc/devon4j-doc.asciidoc
hohwille commented 3 years ago

I fixed the section title out of sequence issues. The other issues are from PR #423 and result from duplicating files from spring for quarkus. As docgen is using the filenames as unique ID we must not have two files with the exact same name within our doc generation process. I will not fix this in this PR. Further, we should first think if duplcating these files is the way to go (then we need to change the name to make it unique) or if it is better to have one doc file in general with a spring and a quarkus sub-section.

hohwille commented 3 years ago

Confirmed that leveloffesets are fixed now:

[INFO] asciidoctor: WARN: devon4j.asciidoc: line 272: id assigned to section already in use: devon4j.asciidoc_guides
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 5: id assigned to section already in use: guide-logging.asciidoc
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 20: id assigned to section already in use: guide-logging.asciidoc_usage
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 23: id assigned to section already in use: guide-logging.asciidoc_maven-integration
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 42: id assigned to section already in use: guide-logging.asciidoc_logger-access
[INFO] asciidoctor: WARN: quarkus/guide-logging.asciidoc: line 69: id assigned to section already in use: guide-logging.asciidoc_configuration
[INFO] asciidoctor: WARN: quarkus/guide-cors-support.asciidoc: line 5: id assigned to section already in use: guide-cors-support.asciidoc
[INFO] asciidoctor: WARN: quarkus/guide-cors-support.asciidoc: line 20: id assigned to section already in use: guide-cors-support.asciidoc_configuring-cors-support
[INFO] Rendered /home/runner/work/devon4j/devon4j/documentation/target/asciidoc/devon4j-doc.asciidoc