Switches to tags

Author: spacether

docs/generators/python.md

@@ -22,7 +22,7 @@ These options may be applied as additional-properties (cli) or configOptions (pl
 |generateSourceCodeOnly|Specifies that only a library source code is to be generated.| |false|
 |hideGenerationTimestamp|Hides the generation timestamp when files are generated.| |true|
 |library|library template (sub-template) to use: urllib3| |urllib3|
-|nonCompliantUseDiscriminatorIfCompositionFails|When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a discriminator is present, then ignore the composition validation errors and attempt to use the discriminator to validate the payload.&lt;br/&gt;Note: setting this to true makes the generated client not comply with json schema because it ignores composition validation errors. Please consider making your schemas more restrictive rather than setting this to true. You can do that by: &lt;br/&gt;- defining the propertyName as an enum with only one value in the schemas that are in your discriminator map&lt;br/&gt;- setting additionalProperties: false in your schemas|<dl><dt>**true**</dt><dd>If composition fails and a discriminator exists, the composition errors will be ignored and validation will be attempted with the discriminator</dd><dt>**false**</dt><dd>Composition validation must succeed. Discriminator validation must succeed.</dd></dl>|false|
+|nonCompliantUseDiscriminatorIfCompositionFails|&lt;p&gt;When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a discriminator is present, then ignore the composition validation errors and attempt to use the discriminator to validate the payload.&lt;/p&gt;&lt;p&gt;Note: setting this to true makes the generated client not comply with json schema because it ignores composition validation errors. Please consider making your schemas more restrictive rather than setting this to true. You can do that by:&lt;/p&gt;&lt;ul&gt;&lt;li&gt;defining the propertyName as an enum with only one value in the schemas that are in your discriminator map&lt;/li&gt;&lt;li&gt;setting additionalProperties: false in your schemas&lt;/li&gt;&lt;/ul&gt;|<dl><dt>**true**</dt><dd>If composition fails and a discriminator exists, the composition errors will be ignored and validation will be attempted with the discriminator</dd><dt>**false**</dt><dd>Composition validation must succeed. Discriminator validation must succeed.</dd></dl>|false|
 |packageName|python package name (convention: snake_case).| |openapi_client|
 |packageUrl|python package URL.| |null|
 |packageVersion|python package version.| |1.0.0|

modules/openapi-json-schema-generator/src/main/java/org/openapitools/codegen/CodegenConstants.java

@@ -407,13 +407,13 @@ public static enum ENUM_PROPERTY_NAMING_TYPE {camelCase, PascalCase, snake_case,
     public static final String NON_COMPLIANT_USE_DISCR_IF_COMPOSITION_FAILS = "nonCompliantUseDiscriminatorIfCompositionFails";
 
     public static final String NON_COMPLIANT_USE_DISCR_IF_COMPOSITION_FAILS_DESC =
-            "When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a " +
+            "<p>When true, If the payload fails to validate against composed schemas (allOf/anyOf/oneOf/not) and a " +
             "discriminator is present, then ignore the composition validation errors and attempt to use the " +
-            "discriminator to validate the payload.<br/>" +
-            "Note: setting this to true makes the generated client not comply with json schema because it ignores " +
+            "discriminator to validate the payload.</p>" +
+            "<p>Note: setting this to true makes the generated client not comply with json schema because it ignores " +
             "composition validation errors. Please consider making your schemas more restrictive rather than " +
-            "setting this to true. You can do that by: <br/>" +
-            "- defining the propertyName as an enum with only one value in the schemas that are in your discriminator map<br/>" +
-            "- setting additionalProperties: false in your schemas";
+            "setting this to true. You can do that by:</p><ul>" +
+            "<li>defining the propertyName as an enum with only one value in the schemas that are in your discriminator map</li>" +
+            "<li>setting additionalProperties: false in your schemas</li></ul>";
 
 }