search

devonfw / docgen

Documentation generator that can generate a complete and self-contained documentation as PDF, ePub and HTML from Asciidoc wiki pages.
Apache License 2.0
8 stars 9 forks source link

Increase UX and avoid the need for external parameters #14

Closed hohwille closed 4 years ago

hohwille commented 4 years ago

With version 4.x an property output.format has been introduced. It has to be set externally (can not be set in pom.xml of using project) otherwise no documentation is build. This is causing problems as we have several projects using docgen as a sub-build in a module and can not easily work with standard processes such as devon release. Also it is bad-practice to require external parameters for a standard build. To solve this we create sub-poms for each supported output format as well as a sub-pom to generate all output formats in parallel. Further this gives the freedom for projects to only extend the regular pom and customize their build for special cases without interfering with build-profile logic that can get in the way.

hohwille commented 4 years ago

Done with PR #15 and released with 5.0.0.