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

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

Start by reviewing the springdoc-openapi setup and the openapi-generator-maven-plugin configuration, especially the inputSpec path and the mvn verify phase. Determine whether the generated specification can be consumed directly for HTML or PDF output without the intermediate YAML file; done means a documented, reproducible configuration based on controller annotations.