From 9fd54bac27355d61e511f2197a832bf566d3fff1 Mon Sep 17 00:00:00 2001
From: Alexander Sysoev <Alexander.Sysoev@jetbrains.com>
Date: Fri, 21 Jun 2024 11:30:50 +0200
Subject: [PATCH] Comments from #109 (#111)

---
 README.md                                    | 6 +++---
 docs/pages/kotlinx-rpc/topics/releases.topic | 9 ++++-----
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 7707e19c..05514512 100644
--- a/README.md
+++ b/README.md
@@ -168,13 +168,13 @@ plugins {
 }
 
 dependencies {
-    // version is 0.1.0 is set by Gradle plugin
+    // version 0.1.0 is set by the Gradle plugin
     implementation("org.jetbrains.kotlinx:kotlinx-rpc-runtime") 
 }
 ```
 
-To learn more about compatibility guaranties - 
-check out our [Releases](https://kotlin.github.io/kotlinx-rpc/releases.html) guide.
+For a full compatibility checklist, 
+see [Releases](https://kotlin.github.io/kotlinx-rpc/releases.html).
 
 ## JetBrains Product
 
diff --git a/docs/pages/kotlinx-rpc/topics/releases.topic b/docs/pages/kotlinx-rpc/topics/releases.topic
index fa7f60df..3fba126a 100644
--- a/docs/pages/kotlinx-rpc/topics/releases.topic
+++ b/docs/pages/kotlinx-rpc/topics/releases.topic
@@ -34,11 +34,10 @@
             for the oldest supported minor version of Kotlin.
         </p>
         <warning>
-            <code>kotlinx-rpc</code> library is <b>not stable</b>.
-            Until it is, such compatibility will all Kotlin versions is not guarantied for our runtime dependencies.
-            However, we will try our best to maintain it,
-            and it is in our plans to ensure all runtime dependencies are compatible will all supported Kotlin versions
-            during the stable release.
+            The <code>kotlinx-rpc</code> library is currently <b>not stable</b>.
+            As a result, we cannot guarantee compatibility with all Kotlin versions for our runtime dependencies at this time.
+            However, we are committed to maintaining compatibility as much as possible.
+            It is in our plans to ensure that all runtime dependencies are compatible with all supported Kotlin versions by the time of the stable release.
         </warning>
     <chapter title="Project configuration" id="project-configuration">
     <p>