conditionally enable dokka plugin based on property.

Author: aaronriekenberg

README.md

@@ -122,7 +122,7 @@ The [Dokka](https://github.com/Kotlin/dokka) plugin is present in `build.gradle.
 To generate HTML documentation use the following command:
 
 ```
-./gradlew dokkaHtml
+./gradlew -PdokkaEnabled=true dokkaHtml
 ```
 
 Open `build/dokka/html/index.html` to view generated documentation.

build.gradle.kts

@@ -20,8 +20,16 @@ plugins {
     id("com.jfrog.artifactory") version "4.26.2"
     `maven-publish`
     jacoco
-    // For now commenting the dokka plugin as latest version 1.6.10 depends on vulnerable versions of jackson/jsoup/etc.
-    // id("org.jetbrains.dokka") version "1.6.10"
+    id("org.jetbrains.dokka") version "1.6.10" apply false
+}
+
+// Conditionally enable dokka only when dokkaEnabled=true property is set.
+// Latest version 1.6.10 depends on vulnerable versions of jackson/jsoup/etc.
+val dokkaEnabled = (project.properties["dokkaEnabled"]?.toString()?.toBoolean()) ?: false
+project.logger.lifecycle("dokkaEnabled = $dokkaEnabled")
+
+if (dokkaEnabled) {
+    apply(plugin = "org.jetbrains.dokka")
 }
 
 apply(plugin = "nebula.release")