Apply Dokka to the root project for aggregation

Author: technoir42

root-conventions/api/root-conventions.api

@@ -0,0 +1,6 @@
+public final class io/technoirlab/conventions/root/RootConventionPlugin : org/gradle/api/Plugin {
+	public fun <init> ()V
+	public synthetic fun apply (Ljava/lang/Object;)V
+	public fun apply (Lorg/gradle/api/Project;)V
+}
+

root-conventions/build.gradle.kts

@@ -0,0 +1,22 @@
+plugins {
+    id("io.technoirlab.conventions.gradle-plugin")
+}
+
+gradlePluginConfig {
+    buildFeatures {
+        abiValidation = true
+    }
+}
+
+dependencies {
+    implementation(libs.dokka.gradle.plugin)
+}
+
+gradlePlugin {
+    plugins {
+        register("rootConventions") {
+            id = "io.technoirlab.conventions.root"
+            implementationClass = "io.technoirlab.conventions.root.RootConventionPlugin"
+        }
+    }
+}

root-conventions/src/main/kotlin/io/technoirlab/conventions/root/RootConventionPlugin.kt

@@ -0,0 +1,13 @@
+package io.technoirlab.conventions.root
+
+import io.technoirlab.conventions.root.configuration.configureDokka
+import org.gradle.api.Plugin
+import org.gradle.api.Project
+
+class RootConventionPlugin : Plugin<Project> {
+    override fun apply(project: Project) = with(project) {
+        pluginManager.apply("org.gradle.lifecycle-base")
+
+        configureDokka()
+    }
+}

root-conventions/src/main/kotlin/io/technoirlab/conventions/root/configuration/Dokka.kt

@@ -0,0 +1,15 @@
+package io.technoirlab.conventions.root.configuration
+
+import org.gradle.api.Project
+import org.gradle.kotlin.dsl.configure
+import org.jetbrains.dokka.gradle.DokkaExtension
+
+internal fun Project.configureDokka() {
+    pluginManager.apply("org.jetbrains.dokka")
+
+    extensions.configure(DokkaExtension::class) {
+        dokkaPublications.named("html") {
+            outputDirectory.set(layout.projectDirectory.dir("docs"))
+        }
+    }
+}

settings-conventions/src/main/kotlin/io/technoirlab/conventions/settings/SettingsConventionPlugin.kt

@@ -27,10 +27,6 @@ class SettingsConventionPlugin : Plugin<Settings> {
             rootProject.name = config.projectId.get()
         }
 
-        gradle.rootProject {
-            pluginManager.apply("org.gradle.lifecycle-base")
-        }
-
         gradle.lifecycle.beforeProject {
             configureMetadata(config.metadata)
         }

settings.gradle.kts

@@ -52,6 +52,7 @@ include(":common-conventions")
 include(":gradle-plugin-conventions")
 include(":jvm-conventions")
 include(":kotlin-multiplatform-conventions")
+include(":root-conventions")
 include(":settings-conventions")
 include(":libraries:gradle-extensions")
 include(":libraries:gradle-test-kit")