Description
Dear all, first of all, many thanks for the nice and helpful tool that you are made.
SITUATION: We need to add API documentation in our project and need to generate that based on only code (if that allows the plugin).
TASK: Generate HTML or PDF API documentation in mvn verify phase based on existing controller code based on openapi annotations springdoc rescource.
ACTIONS: We are using now springdoc-openapi + openapi-generator-maven-plugin pair. After running the instance plugin generates YAML file based on the documents annotations code that could be downloaded and used as a path in the plugin configuration
<inputSpec>${project.basedir}/src/main/resources/static/api.yaml</inputSpec>
RESULT: As a result I was able to get HTML but just based on the existing YAML file.
QUESTION: Is there any better way to generate HTML or pdf (I think you don't have yet a proper generator to support that format yet), just based on code that had the same generated HTML as we had when using the YAML file.
Thanks in advance