feat: Kotlin 2.1.20 release details (#4751)

Author: danil-pavlov

data/releases.yml

@@ -1,5 +1,5 @@
 url: https://github.com/JetBrains/kotlin/releases
 
 latest:
-  version: 2.1.10
-  url: https://github.com/JetBrains/kotlin/releases/tag/v2.1.10
+  version: 2.1.20
+  url: https://github.com/JetBrains/kotlin/releases/tag/v2.1.20

docs/kr.tree

@@ -23,8 +23,9 @@
 		<toc-element topic="competitive-programming.md"/>
 	</toc-element>
 	<toc-element toc-title="What's new in Kotlin">
-		<toc-element toc-title="Kotlin 2.1.0" accepts-web-file-names="whatsnew.html" topic="whatsnew21.md"/>
-		<toc-element toc-title="Kotlin 2.1.20-RC3" topic="whatsnew-eap.md"/>
+		<toc-element toc-title="Kotlin 2.1.20" accepts-web-file-names="whatsnew.html" topic="whatsnew2120.md"/>
+		<toc-element toc-title="Kotlin 2.1.0" topic="whatsnew21.md"/>
+		<toc-element toc-title="Kotlin 2.1.20-RC3" topic="whatsnew-eap.md" hidden="true"/>
 		<toc-element toc-title="Earlier versions">
 			<toc-element toc-title="Kotlin 2.0.20" topic="whatsnew2020.md"/>
 			<toc-element toc-title="Kotlin 2.0.0" topic="whatsnew20.md"/>

docs/topics/configure-build-for-eap.md

@@ -1,8 +1,8 @@
 [//]: # (title: Configure your build for EAP)
 
 <tldr>
-    <!-- <p>No preview versions are currently available</p> -->
-    <p>Latest Kotlin EAP release: <strong>%kotlinEapVersion%</strong></p>
+    <p>No preview versions are currently available</p>
+    <!-- <p>Latest Kotlin EAP release: <strong>%kotlinEapVersion%</strong></p> -->
     <p><a href="eap.md#build-details">Explore Kotlin EAP release details</a></p>
 </tldr>
 
@@ -152,4 +152,4 @@ In the sample Maven project definition, replace `KOTLIN-EAP-VERSION` with the ac
 
 * Report an issue to [our issue tracker, YouTrack](https://kotl.in/issue).
 * Find help in the [#eap channel in Kotlin Slack](https://app.slack.com/client/T09229ZC6/C0KLZSCHF) ([get an invite](https://surveys.jetbrains.com/s3/kotlin-slack-sign-up)).
-* Roll back to the latest stable version: [change it in your build script file](configure-build-for-eap.md#adjust-the-kotlin-version).
+* Roll back to the latest stable version: [change it in your build script file](#adjust-the-kotlin-version).

docs/topics/eap.md

@@ -1,8 +1,10 @@
 [//]: # (title: Participate in the Kotlin Early Access Preview)
 
+<!--
 <tldr>
     <p>Latest Kotlin EAP release: <strong>%kotlinEapVersion%</strong></p>
 </tldr>
+-->
 
 You can participate in the Kotlin Early Access Preview (EAP) to try out the latest Kotlin features before they are released.
 
@@ -35,8 +37,9 @@ In this channel, you can also get notifications about new EAP builds.
 
 ## Build details
 
-<!-- _No preview versions are currently available._ -->  
+_No preview versions are currently available._  
 
+<!--
 <table>
     <tr>
         <th>Build info</th>
@@ -52,4 +55,5 @@ In this channel, you can also get notifications about new EAP builds.
             <p>For more details, please refer to the <a href="https://github.com/JetBrains/kotlin/releases/tag/v2.1.20-RC3">changelog</a> or <a href="whatsnew-eap.md">What's new in Kotlin 2.1.20-RC3</a>.</p>
         </td>
     </tr>
-</table>
+</table>
+-->

docs/topics/gradle/gradle-plugin-variants.md

@@ -16,7 +16,7 @@ Currently, there are the following variants of the Kotlin Gradle plugin:
 | Variant's name | Corresponding Gradle versions |
 |----------------|-------------------------------|
 | `main`         | 7.6.0–7.6.3                   |
-| `gradle80`     | 8.0                           |
+| `gradle80`     | 8.0–8.0.2                     |
 | `gradle81`     | 8.1.1                         |
 | `gradle82`     | 8.2.1–8.4                     |
 | `gradle85`     | 8.5 and higher                |

docs/topics/home.topic

@@ -29,7 +29,7 @@
         <misc>
             <cards narrow="false">
                 <title>Featured topics</title>
-                <a href="whatsnew21.md" summary="New language features and other updates">What's new in Kotlin 2.1.0</a>
+                <a href="whatsnew2120.md" summary="New experimental features, performance improvements, and bug fixes">What's new in Kotlin 2.1.20</a>
                 <a href="releases.md" summary="The latest Kotlin releases and instructions on how to update to them">Kotlin releases</a>
                 <a href="https://kotlinlang.org/api/latest/jvm/stdlib/" summary="Living essentials for everyday work with Kotlin: IO, files, threading, collections, and much more">Standard library API reference</a>
                 <a href="basic-types.md" summary="Kotlin type system: numbers, strings, arrays, and other built-in types">Basic types</a>

docs/topics/lombok.md

@@ -44,7 +44,7 @@ Apply the `kotlin-plugin-lombok` Gradle plugin in the `build.gradle(.kts)` file:
 ```kotlin
 plugins {
     kotlin("plugin.lombok") version "%kotlinVersion%"
-    id("io.freefair.lombok") version "8.10"
+    id("io.freefair.lombok") version "%lombokVersion%"
 }
 ```
 
@@ -54,7 +54,7 @@ plugins {
 ```groovy
 plugins {
     id 'org.jetbrains.kotlin.plugin.lombok' version '%kotlinVersion%'
-    id 'io.freefair.lombok' version '8.10'
+    id 'io.freefair.lombok' version '%lombokVersion%'
 }
 ```
 

docs/topics/multiplatform/multiplatform-compatibility-guide.md

@@ -40,12 +40,11 @@ This section covers incompatible changes that end their deprecation cycle and co
 
 <anchor name="java-source-set-created-by-default"/>
 ### Java source sets created by default
-<primary-label ref="eap"/>
 
 **What's changed?**
 
 To align Kotlin Multiplatform with upcoming changes in Gradle, we are phasing out the `withJava()` function. The `withJava()`
-function enabled integration with Gradle's Java plugins by creating the necessary Java source sets. From Kotlin %kotlinEapVersion%,
+function enabled integration with Gradle's Java plugins by creating the necessary Java source sets. From Kotlin 2.1.20,
 these Java source sets are created by default.
 
 **What's the best practice now?**
@@ -60,7 +59,7 @@ kotlin {
 }
 ``` 
 
-From Kotlin %kotlinEapVersion%, you can remove the `withJava()` function from your build script.
+From Kotlin 2.1.20, you can remove the `withJava()` function from your build script.
 
 In addition, Gradle now only runs Java compile tasks if Java sources are present, triggering a JVM validation 
 diagnostic that previously didn't run before. This diagnostic fails if you explicitly configure an incompatible JVM target
@@ -72,7 +71,7 @@ If your project uses Gradle versions higher than 8.7 and doesn't rely on Gradle
 or a third party Gradle plugin that has a dependency on a Gradle Java plugin, you can remove the `withJava()` function.
 
 If your project uses the [Application](https://docs.gradle.org/current/userguide/application_plugin.html) Gradle Java plugin,
-we recommend migrating to the [new Experimental DSL](whatsnew-eap.md#kotlin-multiplatform-new-dsl-to-replace-gradle-s-application-plugin).
+we recommend migrating to the [new Experimental DSL](whatsnew2120.md#kotlin-multiplatform-new-dsl-to-replace-gradle-s-application-plugin).
 Starting with Gradle 8.7, the Application plugin will no longer work with the Kotlin Multiplatform Gradle plugin.
 
 If you want to use both the Kotlin Multiplatform Gradle plugin and other Gradle plugins for
@@ -86,7 +85,7 @@ Here's the planned deprecation cycle:
 
 * Gradle >8.6: introduce a deprecation warning for any previous version of Kotlin in multiplatform projects using the `withJava()` function.
 * Gradle 9.0: raise this warning to an error.
-* %kotlinEapVersion%: introduce a deprecation warning when using the `withJava()` function with any version of Gradle.
+* 2.1.20: introduce a deprecation warning when using the `withJava()` function with any version of Gradle.
 
 <anchor name="android-target-rename"/>
 ### Rename of `android` target to `androidTarget`

docs/topics/releases.md

@@ -96,6 +96,16 @@ The following table lists details of the latest Kotlin releases:
         <th>Build info</th>
         <th>Build highlights</th>
     </tr>
+   <tr>
+        <td><strong>2.1.20</strong>
+            <p>Released: <strong>March 20, 2025</strong></p>
+            <p><a href="https://github.com/JetBrains/kotlin/releases/tag/v2.1.20" target="_blank">Release on GitHub</a></p>
+        </td>
+        <td>
+           <p>A tooling release for Kotlin 2.1.0 containing new experimental features, performance improvements, and bug fixes.</p>
+            <p>Learn more about Kotlin 2.1.20 in <a href="whatsnew2120.md" target="_blank">What's new in Kotlin 2.1.20</a>.</p>
+        </td>
+    </tr>
     <tr>
         <td><strong>2.1.10</strong>
             <p>Released: <strong>January 27, 2025</strong></p>