Update Gradle dokka configuration to make sure "source" button is vis…

…ible in all API docs (#2518)
Kotlin · Dec 4, 2023 · 93962a8 · 93962a8
1 parent e997d3e
commit 93962a8
Showing 1 changed file with 13 additions and 0 deletions.
diff --git a/gradle/dokka.gradle b/gradle/dokka.gradle
@@ -12,6 +12,9 @@ def documentedSubprojects = ["kotlinx-serialization-core",
                              "kotlinx-serialization-properties",
                              "kotlinx-serialization-hocon",
                              "kotlinx-serialization-protobuf"]
+
+def jvmOnlySubprojects = ["kotlinx-serialization-hocon"]
+
 subprojects {
     if (!(name in documentedSubprojects)) return
     apply plugin: 'org.jetbrains.dokka'
@@ -72,6 +75,16 @@ subprojects {
                     matchingRegex.set("org\\.intellij\\.lang\\.annotations(\$|\\.).*")
                     suppress.set(true)
                 }
+
+                sourceLink {
+                    // sources directory for MPP configured in gradle/configure-source-sets.gradle:61
+                    // in short - kotlin.srcDirs = ["$sourceSet.name/src"]
+                    def sourcesPath = project.name in jvmOnlySubprojects ? "src/main/kotlin" : "$name/src"
+                    def relProjectPath = rootProject.projectDir.toPath().relativize(projectDir.toPath())
+                    localDirectory.set(file(sourcesPath))
+                    remoteUrl.set(new URL("https://github.com/Kotlin/kotlinx.serialization/tree/master/$relProjectPath/$sourcesPath"))
+                    remoteLineSuffix.set("#L")
+                }
             }
         }
     }