Configure the Dokka Gradle plugin and its tasks with code copied and …

…adapted from "kotlin-common"

A source commit: huanshankeji/kotlin-common@157159b

The `dokkaGenerate` tasks fails with the following error:

```text
Execution failed for task ':dokkaGeneratePublicationHtml'.
> Could not resolve all files for configuration ':dokkaHtmlPluginIntransitiveResolver~internal'.
   > Cannot resolve external dependency org.jetbrains.dokka:templating-plugin:2.0.0-Beta because no repositories are defined.
     Required by:
         root project :
   > Cannot resolve external dependency org.jetbrains.dokka:dokka-base:2.0.0-Beta because no repositories are defined.
     Required by:
         root project :
```

This may be a bug from Dokka. See Kotlin/dokka#2260.

.github/workflows/dokka-gh-pages.yml

@@ -2,9 +2,9 @@ name: Deploy the API documentation to GitHub Pages with Dokka
 
 on:
   push:
-    branches: [ "release" ]
+    branches: [ "plugins-release" ]
   pull_request:
-    branches: [ "release" ]
+    branches: [ "plugins-release" ]
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:

build.gradle.kts

@@ -2,10 +2,28 @@ tasks.wrapper {
     distributionType = Wrapper.DistributionType.ALL
 }
 
+plugins {
+    id("org.jetbrains.dokka")
+}
+
 evaluationDependsOnChildren()
 task("publishPluginProjectPlugins") {
     group = "plugin portal"
 
     val pluginProjects = subprojects.filter { it.name.endsWith("plugins") }
     pluginProjects.forEach { dependsOn(it.tasks.named("publishPlugins")) }
 }
+
+
+dependencies {
+    /*
+    "common-gradle-dependencies" not added because it's published in a separate branch
+    "huanshankeji-team-gradle-plugins" not added because it's renamed and more cumbersome to configure, and also because it's only used by us
+     */
+    listOf(
+        "kotlin-common-gradle-plugins",
+        "architecture-common-gradle-plugins",
+    ).forEach {
+        dokka(project(":$it"))
+    }
+}

buildSrc/build.gradle.kts

@@ -38,4 +38,6 @@ dependencies {
     // This is also a bootstrapping dependency.
     implementation("com.huanshankeji:common-gradle-dependencies:0.7.1-20240314-boostrap") { exclude("org.jetbrains.kotlin") }
     */
+
+    implementation("org.jetbrains.dokka:dokka-gradle-plugin:2.0.0-Beta")
 }

buildSrc/src/main/kotlin/aligned-version-plugin-conventions.gradle.kts

@@ -2,6 +2,7 @@ import org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask
 
 plugins {
     id("conventions")
+    id("dokka-convention")
 }
 
 version = alignedPluginVersion

buildSrc/src/main/kotlin/dokka-convention.gradle.kts

@@ -0,0 +1,12 @@
+plugins {
+    id("org.jetbrains.dokka")
+}
+
+dokka {
+    dokkaSourceSets.all {
+        sourceLink {
+            remoteUrl("https://github.com/huanshankeji/kotlin-common/tree/v${version}/${project.name}")
+            remoteLineSuffix.set("#L")
+        }
+    }
+}

gradle.properties

@@ -2,3 +2,5 @@
 #kotlin.mpp.stability.nowarn=true
 # More memory is needed to build "architecture-common-gradle-plugins" since Kotlin 2.0.0
 org.gradle.jvmargs=-Xmx2G
+# for Dokka
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled