Question: Best way to document and generate HTML based on OpenAPI annotations programmatically

[hhovhann]

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