Skip to content

Commit 17cdb90

Browse files
committed
chore: make what's new and releases distinct
1 parent 571d1f1 commit 17cdb90

28 files changed

+130
-31
lines changed

data/releases.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@ url: https://github.com/JetBrains/kotlin/releases
22

33
latest:
44
version: 2.3.0
5-
url: https://github.com/JetBrains/kotlin/releases/tag/v2.3.0
5+
url: https://kotlinlang.org/docs/whatsnew.html

docs/topics/home.topic

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
<cards narrow="false">
3131
<title>Featured topics</title>
3232
<a href="whatsnew23.md" summary="New experimental and stable features, performance improvements, and bug fixes">What's new in Kotlin 2.3.0</a>
33-
<a href="releases.md" summary="The latest Kotlin releases and instructions on how to update to them">Kotlin releases</a>
33+
<a href="releases.md" summary="Learn about the Kotlin release cycle and history">Kotlin release process</a>
3434
<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>
3535
<a href="types-overview.md" summary="Kotlin type system: numbers, strings, arrays, and other built-in types">Types overview</a>
3636
<a href="collections-overview.md" summary="Collections: lists, sets, and maps">Collections</a>

docs/topics/releases.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,15 @@
1-
[//]: # (title: Kotlin releases)
1+
[//]: # (title: Kotlin release process)
2+
3+
<web-summary>Learn about the different types of Kotlin releases there are, how to update to each one, and the history of all releases to date.</web-summary>
24

35
<tldr>
46
<p>Latest Kotlin version: <strong>%kotlinVersion%</strong></p>
57
<p>See <a href="%kotlinLatestWhatsnew%">What's new in Kotlin 2.3.0</a> <!--and find the bug fix details in the <a href="%kotlinLatestUrl%">changelog</a>-->.</p>
68
</tldr>
79

10+
This page explains the Kotlin release cycle and the different types of releases we ship. It also includes details
11+
about past and upcoming Kotlin releases, along with instructions on how to update to a specific release.
12+
813
Since Kotlin 2.0.0, we ship the following types of releases:
914

1015
* _Language releases_ (2._x_._0_) that bring major changes in the language and include tooling updates. Released once in 6 months.
@@ -13,12 +18,9 @@ Since Kotlin 2.0.0, we ship the following types of releases:
1318
Released in 3 months after corresponding _language release_.
1419
* _Bug fix releases_ (2._x_._yz_) that include bug fixes for _tooling releases_. There is no exact release schedule for these releases.
1520

16-
<!-- TODO: uncomment with 2.1.0 release
17-
> For example, for the feature release 1.8.0, we had only one tooling release 1.8.20,
18-
> and several bugfix releases including 1.8.21, 1.8.22.
21+
> For example, for the language release 2.2.0, there was only one tooling release 2.2.20 and one bugfix release 2.2.21.
1922
>
2023
{style="tip"}
21-
-->
2224

2325
For each language and tooling release, we also ship several preview (_EAP_) versions for you to try
2426
new features before they are released. See [Early Access Preview](eap.md) for details.
@@ -134,7 +136,7 @@ Learn more about K2 mode in [our blog](https://blog.jetbrains.com/idea/2025/04/k
134136

135137
Learn more about [types of Kotlin releases and their compatibility](kotlin-evolution-principles.md#language-and-tooling-releases)
136138

137-
## Release details
139+
## Release history
138140

139141
The following table lists details of the latest Kotlin releases:
140142

docs/topics/whatsnew/whatsnew-eap.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44

55
_[Released: %kotlinEapReleaseDate%](eap.md#build-details)_
66

7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
8+
79
<!--
810
> This document doesn't cover all of the features of the Early Access Preview (EAP) release,
911
> but it highlights some major improvements.

docs/topics/whatsnew/whatsnew11.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
[//]: # (title: What's new in Kotlin 1.1)
22

3+
<web-summary>Read the Kotlin 1.1 release notes covering new language features, updates to Kotlin/JVM, and JS, and build tool support for Gradle and Maven.</web-summary>
4+
35
_Released: 15 February 2016_
46

7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
8+
59
## Table of contents
610

711
* [Coroutines](#coroutines-experimental)

docs/topics/whatsnew/whatsnew12.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
[//]: # (title: What's new in Kotlin 1.2)
22

3+
<web-summary>Read the Kotlin 1.2 release notes covering new language features, updates to Kotlin Multiplatform, JVM, and JS, and build tool support for Gradle and Maven.</web-summary>
4+
35
_Released: 28 November 2017_
46

7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
8+
59
## Table of contents
610

711
* [Multiplatform projects](#multiplatform-projects-experimental)

docs/topics/whatsnew/whatsnew13.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
[//]: # (title: What's new in Kotlin 1.3)
22

3+
<web-summary>Read the Kotlin 1.3 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and Wasm, and build tool support for Gradle and Maven.</web-summary>
4+
35
_Released: 29 October 2018_
46

7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
8+
59
## Coroutines release
610

711
After some long and extensive battle testing, coroutines are now released! It means that from Kotlin 1.3 the language

docs/topics/whatsnew/whatsnew14.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
[//]: # (title: What's new in Kotlin 1.4.0)
22

3-
_[Released: 17 August 2020](releases.md#release-details)_
3+
<web-summary>Read the Kotlin 1.4.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and Wasm, and build tool support for Gradle and Maven.</web-summary>
4+
5+
_[Released: 17 August 2020](releases.md#release-history)_
6+
7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
48

59
In Kotlin 1.4.0, we ship a number of improvements in all of its components, with the [focus on quality and performance](https://blog.jetbrains.com/kotlin/2020/08/kotlin-1-4-released-with-a-focus-on-quality-and-performance/).
610
Below you will find the list of the most important changes in Kotlin 1.4.0.

docs/topics/whatsnew/whatsnew1420.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
[//]: # (title: What's new in Kotlin 1.4.20)
22

3-
_[Released: 23 November 2020](releases.md#release-details)_
3+
<web-summary>Read the Kotlin 1.4.20 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and Wasm, and build tool support for Gradle and Maven.</web-summary>
4+
5+
_[Released: 23 November 2020](releases.md#release-history)_
6+
7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
48

59
Kotlin 1.4.20 offers a number of new experimental features and provides fixes and improvements for
610
existing features, including those added in 1.4.0.

docs/topics/whatsnew/whatsnew1430.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,10 @@
11
[//]: # (title: What's new in Kotlin 1.4.30)
22

3-
_[Released: 3 February 2021](releases.md#release-details)_
3+
<web-summary>Read the Kotlin 1.4.30 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and Wasm, and build tool support for Gradle and Maven.</web-summary>
4+
5+
_[Released: 3 February 2021](releases.md#release-history)_
6+
7+
<tldr><p>For information about the Kotlin release cycle, see <a href="releases.md">Kotlin release process</a>.</p></tldr>
48

59
Kotlin 1.4.30 offers preview versions of new language features, promotes the new IR backend of the Kotlin/JVM compiler to
610
Beta, and ships various performance and functional improvements.

0 commit comments

Comments
 (0)