openapi-generator
openapi-generator copied to clipboard
[BUG] html2 generator: documentation for schemas is missing
Description
openapi-generator-maven-plugin fails to include documentation for schemas in the generated HTML documentation, despite configuring the plugin to do so.
openapi-generator version
7.5.0
plugin configuration
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>7.5.0</version>
<executions>
<execution>
<id>generate-html-docs</id>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>${project.basedir}/spec.json</inputSpec>
<generatorName>html2</generatorName>
<output>${project.build.directory}/docs</output>
<generateModelDocumentation>true</generateModelDocumentation>
</configuration>
</execution>
</executions>
</plugin>
OpenAPI declaration file content (spec.json)
{
"openapi": "3.0.0",
"info": {
"title": "Sample contract",
"version": "1.0.0"
},
"paths": {},
"components": {
"schemas": {
"Request": {
"type": "object",
"required": ["token"],
"properties": {
"token": {
"type": "string"
}
}
}
}
}
}
Steps to reproduce
- Use OpenApi spec provided
- Generate html documentation:
mvn clean package
Generated docs
Expected behaviour
The html2 generator of openapi-generator-maven-plugin should incorporate documentation for schemas within the resulting HTML documentation.