From f12509fe49c4ddd866de868fa582d8d208cf2003 Mon Sep 17 00:00:00 2001
From: Matteo Mortari <matteo.mortari@gmail.com>
Date: Wed, 7 Oct 2020 18:03:41 +0200
Subject: [PATCH] BXMSDOC-6656 RN update DTAnalysis wired plugin (Kie7 RN)
 (#2901)

Co-authored-by: sterobin <sterobin@redhat.com>
---
 .../ROOT/pages/DMN/dmn-validation-con.adoc    | 77 +++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 drools-docs/src/modules/ROOT/pages/DMN/dmn-validation-con.adoc

diff --git a/drools-docs/src/modules/ROOT/pages/DMN/dmn-validation-con.adoc b/drools-docs/src/modules/ROOT/pages/DMN/dmn-validation-con.adoc
new file mode 100644
index 00000000000..b27eed848d2
--- /dev/null
+++ b/drools-docs/src/modules/ROOT/pages/DMN/dmn-validation-con.adoc
@@ -0,0 +1,77 @@
+[id='dmn-validation-con_{context}']
+= Configurable DMN validation in {PRODUCT}
+
+By default, the `kie-maven-plugin` component in the `pom.xml` file of your {PRODUCT} project uses the following `<validateDMN>` configurations to perform pre-compilation validation of DMN model assets and to perform DMN decision table static analysis:
+
+* `VALIDATE_SCHEMA`: DMN model files are verified against the DMN specification XSD schema to ensure that the files are valid XML and compliant with the specification.
+* `VALIDATE_MODEL`: The pre-compilation analysis is performed for the DMN model to ensure that the basic semantic is aligned with the DMN specification.
+* `ANALYZE_DECISION_TABLE`: DMN decision tables are statically analyzed for gaps or overlaps and to ensure that the semantic of the decision table follows best practices.
+
+You can modify the default DMN validation and DMN decision table analysis behavior to perform only a specified validation during the project build, or you can disable this default behavior completely, as shown in the following examples:
+
+.Default configuration for DMN validation and decision table analysis
+[source,xml]
+----
+<plugin>
+  <groupId>org.kie</groupId>
+  <artifactId>kie-maven-plugin</artifactId>
+  <extensions>true</extensions>
+  <configuration>
+    <validateDMN>VALIDATE_SCHEMA,VALIDATE_MODEL,ANALYZE_DECISION_TABLE</validateDMN>
+  </configuration>
+</plugin>
+----
+
+.Configuration to perform only the DMN decision table static analysis
+[source,xml]
+----
+<plugin>
+  <groupId>org.kie</groupId>
+  <artifactId>kie-maven-plugin</artifactId>
+  <extensions>true</extensions>
+  <configuration>
+    <validateDMN>ANALYZE_DECISION_TABLE</validateDMN>
+  </configuration>
+</plugin>
+----
+
+.Configuration to perform only the XSD schema validation
+[source,xml]
+----
+<plugin>
+  <groupId>org.kie</groupId>
+  <artifactId>kie-maven-plugin</artifactId>
+  <extensions>true</extensions>
+  <configuration>
+    <validateDMN>VALIDATE_SCHEMA</validateDMN>
+  </configuration>
+</plugin>
+----
+
+.Configuration to perform only the DMN model validation
+[source,xml]
+----
+<plugin>
+  <groupId>org.kie</groupId>
+  <artifactId>kie-maven-plugin</artifactId>
+  <extensions>true</extensions>
+  <configuration>
+    <validateDMN>VALIDATE_MODEL</validateDMN>
+  </configuration>
+</plugin>
+----
+
+.Configuration to disable all DMN validation
+[source,xml]
+----
+<plugin>
+  <groupId>org.kie</groupId>
+  <artifactId>kie-maven-plugin</artifactId>
+  <extensions>true</extensions>
+  <configuration>
+    <validateDMN>disable</validateDMN>
+  </configuration>
+</plugin>
+----
+
+NOTE: If you enter an unrecognized `<validateDMN>` configuration flag, all pre-compilation validation is disabled and the Maven plugin emits related log messages.