refactor: migrate back to Dokka

* Add V2Enabled flag
* Update GitHub Actions docs workflow
* Update Dokka DSL usage

Author: EdricChan03

.github/workflows/docs.yml

@@ -47,14 +47,14 @@ jobs:
           gradle-home-cache-strict-match: true
 
       - name: Build docs
-        run: ./gradlew dokkatooGeneratePublicationHtml --stacktrace
+        run: ./gradlew dokkaGeneratePublicationHtml --stacktrace
 
       - name: Setup Pages
         uses: actions/configure-pages@v3
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v1
         with:
-          # Upload Dokkatoo folder
+          # Upload Dokka folder
           path: './build/dokka/html'
       - name: Deploy to GitHub Pages
         id: deployment

buildSrc/build.gradle.kts

@@ -11,6 +11,6 @@ dependencies {
     implementation(libs.kotlinx.serialization.json)
 
     // For precompiled scripts
-    implementation(libs.dokkatoo.plugin)
+    implementation(libs.dokka.plugin)
     implementation(libs.kotlin.mpp.plugin)
 }

buildSrc/src/main/kotlin/io/github/edricchan03/koogle_api/module.gradle.kts

@@ -6,7 +6,7 @@ package io.github.edricchan03.koogle_api
 
 plugins {
     kotlin("multiplatform")
-    dev.adamko.`dokkatoo-html`
+    org.jetbrains.dokka
 }
 
 group = "io.github.edricchan03.koogle-api"
@@ -24,12 +24,12 @@ kotlin {
     }
 }
 
-dokkatoo {
+dokka {
     val moduleDoc = file("Module.md")
     val moduleDocExists = moduleDoc.exists()
     if (!moduleDocExists) logger.warn("The expected Module.md file at $moduleDoc doesn't exist!")
 
-    dokkatooSourceSets.configureEach {
+    dokkaSourceSets.configureEach {
 
         if (moduleDocExists) includes.from(moduleDoc)
 

gradle.properties

@@ -2,3 +2,5 @@ kotlin.code.style=official
 kotlin.js.generate.executable.default=false
 
 org.gradle.configuration-cache=true
+
+org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled

gradle/libs.versions.toml

@@ -12,10 +12,10 @@ ktor-serialization-kotlinx-json = { module = "io.ktor:ktor-serialization-kotlinx
 kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinx-serialization" }
 
 # For precompiled script plugins
-dokkatoo-plugin = { module = "dev.adamko.dokkatoo:dokkatoo-plugin", version.ref = "dokkatoo" }
+dokka-plugin = { module = "org.jetbrains.dokka:dokka-gradle-plugin", version.ref = "dokka" }
 kotlin-mpp-plugin = { module = "org.jetbrains.kotlin.multiplatform:org.jetbrains.kotlin.multiplatform.gradle.plugin", version.ref = "kotlin" }
 
 [plugins]
-dokkatoo-html = { id = "dev.adamko.dokkatoo-html", version.ref = "dokkatoo" }
+dokka = { id = "org.jetbrains.dokka", version.ref = "dokka" }
 kotlin-mpp = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
 kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }

plugins/generator/build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
     `java-gradle-plugin`
     `kotlin-dsl`
     kotlin("plugin.serialization") version embeddedKotlinVersion
-    alias(libs.plugins.dokkatoo.html)
+    alias(libs.plugins.dokka)
 }
 
 group = "io.github.edricchan03.koogle-api"
@@ -29,10 +29,10 @@ dependencies {
     implementation(libs.kotlinx.serialization.json)
 }
 
-dokkatoo {
+dokka {
     modulePath = "plugins/generator"
 
-    dokkatooSourceSets.configureEach {
+    dokkaSourceSets.configureEach {
         includes.from("Module.md")
 
         // Link to source