From 4f0058aae6033a75ddb034ea35f1283fc9ef944d Mon Sep 17 00:00:00 2001
From: Danil Pavlov <danil.pavlov@jetbrains.com>
Date: Fri, 1 Sep 2023 12:41:04 +0200
Subject: [PATCH] update: warnings for the new and the legacy memory manager
 pages (#3761)

---
 .../multiplatform-mobile-concurrency-and-coroutines.md        | 4 +++-
 .../multiplatform-mobile-concurrency-overview.md              | 4 +++-
 .../multiplatform-mobile-concurrent-mutability.md             | 4 +++-
 docs/topics/native/native-immutability.md                     | 4 +++-
 docs/topics/native/native-ios-integration.md                  | 2 +-
 docs/topics/native/native-memory-manager.md                   | 4 ++--
 6 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-and-coroutines.md b/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-and-coroutines.md
index a2c9dbe2911..e02d7f3c7d4 100644
--- a/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-and-coroutines.md
+++ b/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-and-coroutines.md
@@ -3,7 +3,9 @@
 > This page describes the features of the legacy memory manager. Check out [Kotlin/Native memory management](native-memory-manager.md)
 > to learn about the new memory manager, which has been enabled by default since Kotlin 1.7.20.
 >
-{type="note"}
+> For more information on the concurrent programming in Kotlin, see the [Coroutines guide](coroutines-guide.md).
+>
+{type="warning"}
 
 When working with mobile platforms, you may need to write multithreaded code that runs in parallel. For this, 
 you can use the [standard](#coroutines) `kotlinx.coroutines` library or its [multithreaded version](#multithreaded-coroutines) 
diff --git a/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-overview.md b/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-overview.md
index c87abad4711..458f0d0df27 100644
--- a/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-overview.md
+++ b/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrency-overview.md
@@ -3,7 +3,9 @@
 > This page describes the features of the legacy memory manager. Check out [Kotlin/Native memory management](native-memory-manager.md)
 > to learn about the new memory manager, which has been enabled by default since Kotlin 1.7.20.
 >
-{type="note"}
+> For more information on the concurrent programming in Kotlin, see the [Coroutines guide](coroutines-guide.md).
+>
+{type="warning"}
 
 When you extend your development experience from Android to Kotlin Multiplatform for mobile, you will encounter a different state 
 and concurrency model for iOS. This is a Kotlin/Native model that compiles Kotlin code to native binaries that can run without a virtual machine, for example on iOS. 
diff --git a/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrent-mutability.md b/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrent-mutability.md
index 53d9a9550cf..83917d6289d 100644
--- a/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrent-mutability.md
+++ b/docs/topics/multiplatform-mobile/multiplatform-mobile-concurrent-mutability.md
@@ -3,7 +3,9 @@
 > This page describes the features of the legacy memory manager. Check out [Kotlin/Native memory management](native-memory-manager.md)
 > to learn about the new memory manager, which has been enabled by default since Kotlin 1.7.20.
 >
-{type="note"}
+> For more information on the concurrent programming in Kotlin, see the [Coroutines guide](coroutines-guide.md).
+>
+{type="warning"}
 
 When it comes to working with iOS, [Kotlin/Native's state and concurrency model](multiplatform-mobile-concurrency-overview.md) has [two simple rules](multiplatform-mobile-concurrency-overview.md#rules-for-state-sharing).
 
diff --git a/docs/topics/native/native-immutability.md b/docs/topics/native/native-immutability.md
index 6d9920edfec..60e351cc1e9 100644
--- a/docs/topics/native/native-immutability.md
+++ b/docs/topics/native/native-immutability.md
@@ -3,7 +3,9 @@
 > This page describes the features of the legacy memory manager. Check out [Kotlin/Native memory management](native-memory-manager.md)
 > to learn about the new memory manager, which has been enabled by default since Kotlin 1.7.20.
 >
-{type="note"}
+> For more information on the concurrent programming in Kotlin, see the [Coroutines guide](coroutines-guide.md).
+>
+{type="warning"}
 
 Kotlin/Native implements strict mutability checks, ensuring
 the important invariant that the object is either immutable or
diff --git a/docs/topics/native/native-ios-integration.md b/docs/topics/native/native-ios-integration.md
index 9f55d6e8c8c..73d177e0b3b 100644
--- a/docs/topics/native/native-ios-integration.md
+++ b/docs/topics/native/native-ios-integration.md
@@ -1,7 +1,7 @@
 [//]: # (title: iOS integration)
 
 > This page describes the new memory manager enabled by default since Kotlin 1.7.20. See our [migration guide](native-migration-guide.md)
-> to move your projects from the legacy memory manager.
+> to move your projects from the legacy memory manager that will be removed in Kotlin 1.9.20.
 >
 {type="note"}
 
diff --git a/docs/topics/native/native-memory-manager.md b/docs/topics/native/native-memory-manager.md
index 4f3ddee07e2..9fc400fab37 100644
--- a/docs/topics/native/native-memory-manager.md
+++ b/docs/topics/native/native-memory-manager.md
@@ -1,7 +1,7 @@
 [//]: # (title: Kotlin/Native memory management)
 
-> This page describes features of the new memory manager enabled by default since Kotlin 1.7.20.
-> See our [migration guide](native-migration-guide.md) to move your projects from the legacy memory manager.
+> This page describes features of the new memory manager enabled by default since Kotlin 1.7.20. See our [migration guide](native-migration-guide.md)
+> to move your projects from the legacy memory that will be removed in Kotlin 1.9.20.
 >
 {type="note"}