New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat: update the Kotlin release information and evolution principles #4173
Conversation
docs/topics/kotlin-evolution.md
Outdated
|
||
The Language Committee makes final decisions on what incompatible changes will be made and what exact measures should be taken to make user updates comfortable. In doing so, it relies on a set of guidelines available [here](https://kotlinfoundation.org/language-committee-guidelines/). | ||
The Language Committee makes final decisions on what incompatible changes will be made and what exact measures should be taken to make user updates comfortable. | ||
In doing so, it relies on a set of [Language committee guidelines](https://kotlinfoundation.org/language-committee-guidelines/). | ||
|
||
## Feature releases and incremental releases |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
seems incremental releases should be renamed to "tooling releases" as we use that naming below
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Updated everywhere on a page
|
||
For example, for the feature release 1.3 we had several incremental releases including 1.3.10, 1.3.20, and 1.3.70. | ||
For 1.3.70, we had 2 bug fix releases – 1.3.71 and 1.3.72. | ||
> For example, for the feature release 1.8.0, we had only one tooling release 1.8.20, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is it ok that we start that part with "Since Kotlin 2.0.0, we.." and then give an example about 1.8.20?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah, a bit strange.
Let's comment this tip and bring it back when 2.1.0 will happen.
docs/topics/releases.md
Outdated
* _Incremental releases_ (1._x_._y_) that are shipped between feature releases and include updates in the tooling, | ||
performance improvements, and bug fixes. | ||
* _Bug fix releases_ (1._x_._yz_) that include bug fixes for incremental releases. | ||
* _Language releases_ (2._x_._0_) that bring major changes in the language. Released once in 6 months. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
let's add that Language releases also include tooling updates
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added
@@ -1517,7 +1517,7 @@ to help you decide which suggestions to accept and which to ignore. | |||
|
|||
![Migration inspections](migration-inspection-wn.png) | |||
|
|||
Kotlin 1.4.0 is a [feature release](kotlin-evolution.md#feature-releases-and-incremental-releases) and therefore can | |||
Kotlin 1.4.0 is a [feature release](kotlin-evolution.md#language-and-tooling-releases) and therefore can |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For the record, not sure that we should fix the namen for the previous 1.x.x release.
I fixed the anchors just to be sure that everything works.
…4173) * update: update kotlin-evolution.md * update: update releases.md * update: update wording * update: review fixes, anchor fixes * fix: fix one more anchor
…4173) * update: update kotlin-evolution.md * update: update releases.md * update: update wording * update: review fixes, anchor fixes * fix: fix one more anchor
KT-67865 [Docs][K2] update Kotlin Release Page
KT-67944 [Docs][K2][IDE] Update IDE support description for K2