From 1e95d36809451643246f211df4385d5d91e6023a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=A9mie=20Bresson?= Date: Mon, 30 Jul 2018 17:53:26 +0200 Subject: [PATCH] Add "Validate spec on generation by default" section (#683) --- docs/migration-guide.adoc | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/migration-guide.adoc b/docs/migration-guide.adoc index 3745556cc9f1..c7315c1e8d60 100644 --- a/docs/migration-guide.adoc +++ b/docs/migration-guide.adoc @@ -17,6 +17,17 @@ Version `3.2.0` is a minor version of OpenAPI-Generator, in comparison to `3.1.x The default value of some options might change. Projects relying on generated code might need to be adapted. +==== Validate spec on generation by default + +The default is to validate the spec during generation. If the spec has errors, +they will appear as errors or warnings to the user. This prevent generation of the project. + +If you want to switch back to the `3.1.x` behavior you can use: + +* Set the `validateSpec` option to `false` if you are using the Maven or Gradle plugin +* Use the command line option `--skip-validate-spec` if you are using the CLI + + ==== Model (all languages) In `CodegenModel` and in `CodegenOperation` we use now our own class `org.openapitools.codegen.CodegenDiscriminator` instead of `io.swagger.v3.oas.models.media.Discriminator`.