From 123e8b2fca3d82d58a48b28c3a3a6627f30664d3 Mon Sep 17 00:00:00 2001
From: Rodrigo Lazo Paz <rlazo@google.com>
Date: Fri, 22 Aug 2025 16:12:17 -0400
Subject: [PATCH 1/2] [Ai] Add support for serialization links

Dackka can generate links to code in other packages/sites, but has to
be configured to do so. This change adds the necessary configuration
so links to `kotlinx.serialization` code are correctly generated when
processing refdocs.
---
 .../package-lists/serialization/package-list  | 25 +++++++++++++++++++
 .../gradle/plugins/DackkaGenerationTask.kt    |  1 +
 2 files changed, 26 insertions(+)
 create mode 100644 kotlindoc/package-lists/serialization/package-list

diff --git a/kotlindoc/package-lists/serialization/package-list b/kotlindoc/package-lists/serialization/package-list
new file mode 100644
index 00000000000..1ac6b91832f
--- /dev/null
+++ b/kotlindoc/package-lists/serialization/package-list
@@ -0,0 +1,25 @@
+$dokka.format:html-v1
+$dokka.linkExtension:html
+
+module:kotlinx-serialization-cbor
+kotlinx.serialization.cbor
+module:kotlinx-serialization-core
+kotlinx.serialization
+kotlinx.serialization.builtins
+kotlinx.serialization.descriptors
+kotlinx.serialization.encoding
+kotlinx.serialization.modules
+module:kotlinx-serialization-hocon
+kotlinx.serialization.hocon
+kotlinx.serialization.hocon.serializers
+module:kotlinx-serialization-json
+kotlinx.serialization.json
+module:kotlinx-serialization-json-io
+kotlinx.serialization.json.io
+module:kotlinx-serialization-json-okio
+kotlinx.serialization.json.okio
+module:kotlinx-serialization-properties
+kotlinx.serialization.properties
+module:kotlinx-serialization-protobuf
+kotlinx.serialization.protobuf
+kotlinx.serialization.protobuf.schema
diff --git a/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt b/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt
index 058a4f51e98..8caf0bfec69 100644
--- a/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt
+++ b/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt
@@ -182,6 +182,7 @@ constructor(private val workerExecutor: WorkerExecutor) : GenerateDocumentationT
         "firebase" to "https://firebase.google.com/docs/reference/kotlin/",
         "coroutines" to "https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/",
         "kotlin" to "https://kotlinlang.org/api/latest/jvm/stdlib/",
+        "serialization" to "https://kotlinlang.org/api/kotlinx.serialization",
       )
 
     return packageLists

From acbd61588681329412618d7e101774f3e3e34f31 Mon Sep 17 00:00:00 2001
From: Rodrigo Lazo <rlazo@users.noreply.github.com>
Date: Mon, 25 Aug 2025 11:55:25 -0400
Subject: [PATCH 2/2] Update
 plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
---
 .../google/firebase/gradle/plugins/DackkaGenerationTask.kt    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt b/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt
index 8caf0bfec69..5e6c503ee94 100644
--- a/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt
+++ b/plugins/src/main/java/com/google/firebase/gradle/plugins/DackkaGenerationTask.kt
@@ -179,10 +179,10 @@ constructor(private val workerExecutor: WorkerExecutor) : GenerateDocumentationT
         "android" to "https://developer.android.com/reference/kotlin/",
         "androidx" to "https://developer.android.com/reference/kotlin/",
         "google" to "https://developers.google.com/android/reference/",
-        "firebase" to "https://firebase.google.com/docs/reference/kotlin/",
         "coroutines" to "https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/",
+        "firebase" to "https://firebase.google.com/docs/reference/kotlin/",
         "kotlin" to "https://kotlinlang.org/api/latest/jvm/stdlib/",
-        "serialization" to "https://kotlinlang.org/api/kotlinx.serialization",
+        "serialization" to "https://kotlinlang.org/api/kotlinx.serialization/",
       )
 
     return packageLists