search

swagger-api / swagger-codegen

swagger-codegen contains a template-driven engine to generate documentation, API clients and server stubs in different languages by parsing your OpenAPI / Swagger definition.
http://swagger.io
Apache License 2.0
16.98k stars 6.03k forks source link

Fix documentation #9742

Open MaksimRT opened 5 years ago

MaksimRT commented 5 years ago
Description

Please fix documentation here.

Swagger-codegen version

4.0.2

Swagger declaration file content or url
<plugin>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-codegen-maven-plugin</artifactId>
    <version>>4.0.2</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/api.yaml</inputSpec>
                <language>java</language>
                <configOptions>
                   <sourceFolder>src/gen/java/main</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>
Command line used for generation

openapi-generator:generate -f pom.xml

An error

[ERROR] Failed to execute goal io.swagger:swagger-codegen-maven-plugin:>4.0.2:generate (default-cli) on project demo: The parameters 'inputSpec', 'language' for goal io.swagger:swagger-codegen-maven-plugin:>4.0.2:generate are missing or invalid -> [Help 1]

Suggest a fix/enhancement

Move tag from to section.

HugoMario commented 5 years ago

hi @MaksimRT, i think you're in the wrong project. going to close it, but if i'm wrong, please let me know

MaksimRT commented 5 years ago

@HugoMario I am talking about swagger-codegen-maven-plugin README.md file.

The full path is https://github.com/swagger-api/swagger-codegen/blob/master/modules/swagger-codegen-maven-plugin/README.md

HugoMario commented 5 years ago

oh ok, got it. sorry for mistake