Add Dokka plugin and rework publishing

Signed-off-by: Dmitry Sulman <[email protected]>

Author: dmitrysulman

build.gradle.kts

@@ -0,0 +1,16 @@
+plugins {
+    kotlin("jvm")
+    alias(libs.plugins.jreleaser)
+}
+
+repositories {
+    mavenCentral()
+    gradlePluginPortal()
+}
+
+val jreleaserFullRelease by tasks.existing {
+    subprojects.forEach {
+        val copyStagingDeployToRoot by it.tasks.existing
+        dependsOn(copyStagingDeployToRoot)
+    }
+}

buildSrc/build.gradle.kts

@@ -1,25 +1,18 @@
 plugins {
     `kotlin-dsl`
-    alias(libs.plugins.jreleaser)
 }
 
 repositories {
     mavenCentral()
+    gradlePluginPortal()
 }
 
 kotlin {
     jvmToolchain(17)
 }
 
 dependencies {
+    implementation(libs.dokka.gradlePlugin)
+    implementation(libs.dokka.javadocPlugin)
     implementation(libs.kotlin.gradlePlugin)
-}
-
-val copyStagingDeploy by tasks.registering(Copy::class) {
-    from("../logback-access-reactor-netty/build/staging-deploy")
-    into("build/staging-deploy")
-}
-
-tasks.jreleaserFullRelease {
-    dependsOn(copyStagingDeploy)
 }

buildSrc/src/main/kotlin/conventions.gradle.kts

@@ -3,6 +3,8 @@ import org.jetbrains.kotlin.gradle.dsl.JvmTarget
 plugins {
     kotlin("jvm")
     `maven-publish`
+    id("org.jetbrains.dokka")
+    id("org.jetbrains.dokka-javadoc")
 }
 
 group = "io.github.dmitrysulman"
@@ -26,18 +28,32 @@ kotlin {
 
 java {
     targetCompatibility = JavaVersion.VERSION_1_8
-    withJavadocJar()
     withSourcesJar()
 }
 
 tasks.withType<Test>().configureEach {
     useJUnitPlatform()
 }
 
+val copyStagingDeployToRoot by tasks.registering(Copy::class) {
+    group = "publishing"
+    dependsOn(tasks.publish)
+    from("./build/staging-deploy")
+    into("../build/staging-deploy")
+}
+
+val dokkaJavadocJar by tasks.registering(Jar::class) {
+    group = "dokka"
+    dependsOn(tasks.dokkaGeneratePublicationJavadoc)
+    from(tasks.dokkaGeneratePublicationJavadoc.flatMap { it.outputDirectory })
+    archiveClassifier.set("javadoc")
+}
+
 publishing {
     publications {
         create<MavenPublication>("maven") {
             from(components["java"])
+            artifact(dokkaJavadocJar)
             pom {
                 afterEvaluate {
                     pom.name = project.description

gradle.properties

@@ -2,3 +2,5 @@ version=1.0.0-SNAPSHOT
 org.gradle.caching=true
 org.gradle.configuration-cache=true
 org.gradle.jvmargs=-Xmx2g
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
+org.jetbrains.dokka.experimental.gradle.pluginMode.noWarn=true

gradle/libs.versions.toml

@@ -1,4 +1,5 @@
 [versions]
+dokka = "2.0.0"
 jreleaser = "1.18.0"
 junit = "5.12.2"
 kotlin = "2.1.20"
@@ -8,6 +9,8 @@ reactorNetty = "1.2.6-SNAPSHOT"
 slf4j = "2.0.17"
 
 [libraries]
+dokka-gradlePlugin = { group = "org.jetbrains.dokka", name = "dokka-gradle-plugin", version.ref = "dokka" }
+dokka-javadocPlugin = { group = "org.jetbrains.dokka-javadoc", name = "org.jetbrains.dokka-javadoc.gradle.plugin", version.ref = "dokka" }
 junit-jupiter = { group = "org.junit.jupiter", name = "junit-jupiter", version.ref = "junit" }
 junit-platformLauncher = { group = "org.junit.platform", name = "junit-platform-launcher" }
 kotlin-gradlePlugin = { group = "org.jetbrains.kotlin", name = "kotlin-gradle-plugin", version.ref = "kotlin" }
@@ -18,4 +21,4 @@ reactorNetty-http = { group = "io.projectreactor.netty", name = "reactor-netty-h
 slf4j-api = { group = "org.slf4j", name = "slf4j-api", version.ref = "slf4j" }
 
 [plugins]
-jreleaser = {  id = "org.jreleaser", version.ref = "jreleaser" }
+jreleaser = { id = "org.jreleaser", version.ref = "jreleaser" }