Update Dokka to 2.2.0-Beta and fix unresolved links (#602)

Author: whyoleg

core/build.gradle.kts

@@ -416,5 +416,8 @@ apiValidation {
 }
 
 dependencies {
+    // make samples runnable via Kotlin playground
+    dokkaHtmlPlugin("org.jetbrains.dokka:kotlin-playground-samples-plugin")
+
     dokka(project)
 }

core/common/src/Clock.kt

@@ -84,7 +84,7 @@ private class InstantTimeMark(private val instant: Instant, private val clock: C
 }
 
 /**
- * Creates a [Clock] that uses the [time mark at the moment of creation][TimeMark.markNow] to determine how [far][TimeMark.elapsedNow]
+ * Creates a [Clock] that uses the [time mark at the moment of creation][TimeSource.markNow] to determine how [far][TimeMark.elapsedNow]
  * the [current moment][Clock.now] is from the [origin].
  *
  * This clock stores the [TimeMark] at the moment of creation, so repeatedly creating [Clock]s from the same [TimeSource] results

core/common/src/serializers/InstantSerializers.kt

@@ -29,7 +29,7 @@ import kotlin.time.Instant
  * to avoid conflicts with serializers defined by other libraries and client code.
  *
  * When serializing, the [Instant] value is formatted as a string using the specified [format]
- * in the [ZERO][UtcOffset.ZERO] UTC offset.
+ * in the [ZERO][kotlinx.datetime.UtcOffset.ZERO] UTC offset.
  *
  * This serializer is abstract and must be subclassed to provide a concrete serializer.
  * Example:

core/commonKotlin/src/internal/TimeZoneRules.kt

@@ -185,10 +185,10 @@ internal class RecurringZoneRules(
     }
 
     /**
-     * IMPORTANT: keep this implementation in sync with [TimeZoneRulesFoundation.infoAtDatetime].
+     * IMPORTANT: keep this implementation in sync with [TimeZoneRulesCommon.infoAtDatetime].
      * The algorithms and corner-case handling should stay identical so that Darwin (Foundation-based)
      * and tzdb-based platforms compute the same results.  When you change logic here, reflect the
-     * same change in [TimeZoneRulesFoundation.infoAtDatetime].
+     * same change in [TimeZoneRulesCommon.infoAtDatetime].
      */
     fun infoAtLocalDateTime(localDateTime: LocalDateTime, offsetAtYearStart: UtcOffset): OffsetInfo {
         val year = localDateTime.year

core/darwin/src/Converters.kt

@@ -56,7 +56,7 @@ internal fun NSDate.toKotlinInstant(): kotlinx.datetime.Instant =
  * Converts the [TimeZone] to [NSTimeZone].
  *
  * If the time zone is represented as a fixed number of seconds from UTC+0 (for example, if it is the result of a call
- * to [TimeZone.offset]) and the offset is not given in even minutes but also includes seconds, this method throws
+ * to [FixedOffsetTimeZone.offset]) and the offset is not given in even minutes but also includes seconds, this method throws
  * [IllegalArgumentException] to denote that lossy conversion would happen, as Darwin internally rounds the offsets
  * to the nearest minute.
  *

gradle.properties

@@ -8,7 +8,7 @@ versionSuffix=SNAPSHOT
 tzdbVersion=2025c
 
 defaultKotlinVersion=2.1.20
-dokkaVersion=2.0.0
+dokkaVersion=2.2.0-Beta
 serializationVersion=1.6.2
 benchmarksVersion=0.7.2
 bcvVersion=0.17.0
@@ -19,9 +19,6 @@ java.modularToolchainVersion=11
 kotlin.mpp.applyDefaultHierarchyTemplate=false
 kotlin.native.ignoreDisabledTargets=true
 
-org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
-org.jetbrains.dokka.experimental.gradle.pluginMode.nowarn=true
-
 # stop using pre-HMPP IDEA import workaround in kotlinx.team.infra
 useNativeBuildInfraInIdea=true