diff --git a/README.md b/README.md
index c584e97..f151f5d 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,21 @@
[![official project](http://jb.gg/badges/official.svg)](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-# Compose Multiplatform mobile application
+# [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) mobile application
> **Note**
-> Compose Multiplatform is in Alpha. It may change incompatibly and require manual migration in the future.
+> Compose Multiplatform for iOS is in Alpha. It may change incompatibly and require manual migration in the future.
> We would appreciate your feedback on it in the public Slack channel [#compose-ios](https://kotlinlang.slack.com/archives/C0346LWVBJ4/p1678888063176359).
> If you face any issues, please report them on [GitHub](https://github.com/JetBrains/compose-multiplatform/issues).
-You can use this template to start developing your own [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform) mobile application targeting Android and iOS.
-Follow out tutorial below to get your first Compose Multiplatform app up and running.
+You can use this template to start developing your own [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform#readme) mobile application targeting Android and iOS.
+Follow our tutorial below to get your first Compose Multiplatform app up and running.
The result will be a [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html) project that uses Compose Multiplatform UI framework.
![](readme_images/banner.png)
+If you want to create an application targeting desktop platforms – Windows, macOS, and Linux,
+use the [Compose Multiplatform for Desktop template](https://github.com/JetBrains/compose-multiplatform-desktop-template#readme).
+
## Set up the environment
> **Warning**
@@ -137,21 +140,20 @@ To do so, you'll need the following:
> **Note**
> Before you continue, we suggest creating a simple "Hello, world!" project in Xcode to ensure you can successfully run apps on your device.
-> You can follow the instructions below or watch this [this Standford CS193P lecture recording](https://youtu.be/bqu6BquVi2M?start=716&end=1399).
->
->
->
-> How to create and run a simple project in Xcode
->
-> 1. On the Xcode welcome screen, select **Create a new project in Xcode**.
-> 2. On the **iOS** tab, choose the **App** template. Click **Next**.
-> 3. Specify the product name and keep other settings default. Click **Next**.
-> 4. Select where to store the project on your computer and click **Create**. You'll see an app that displays "Hello, world!" on the device screen.
-> 5. At the top of your Xcode screen, click on a device name near the **Run** button.
-> 6. Plug in your device to the computer. You'll see this device in the list of run options.
-> 7. Choose your device and click **Run**.
->
->
+> You can follow the instructions below or watch this [Standford CS193P lecture recording](https://youtu.be/bqu6BquVi2M?start=716&end=1399).
+
+
+How to create and run a simple project in Xcode
+
+1. On the Xcode welcome screen, select **Create a new project in Xcode**.
+2. On the **iOS** tab, choose the **App** template. Click **Next**.
+3. Specify the product name and keep other settings default. Click **Next**.
+4. Select where to store the project on your computer and click **Create**. You'll see an app that displays "Hello, world!" on the device screen.
+5. At the top of your Xcode screen, click on a device name near the **Run** button.
+6. Plug in your device to the computer. You'll see this device in the list of run options.
+7. Choose your device and click **Run**.
+
+
##### Finding your Team ID
@@ -247,7 +249,7 @@ You can now make some changes in the code and see that they will be visible in b
}
```
-3. Re-run both `androidApp` and `iosApp` configurations. You'll see this change reflected on both the Android and iOS apps:
+3. Re-run both `androidApp` and `iosApp` configurations. You'll see this change reflected in both the Android and iOS apps:
@@ -260,7 +262,7 @@ open the `iosApp/Configuration/Config.xcconfig` file in Android Studio. The conf
* `BUNDLE_ID` that [uniquely identifies the app throughout the system](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleidentifier#discussion)
* `TEAM_ID`, [a unique identifier generated by Apple that's assigned to your team](https://developer.apple.com/help/account/manage-your-team/locate-your-team-id/#:~:text=A%20Team%20ID%20is%20a,developer%20in%20App%20Store%20Connect)
-To configure the `APP_NAME` option, open `Config.xcconfig` in any text editor *before opening* the project in Android Studio, and set the desired name.
+To configure the `APP_NAME` option, open `Config.xcconfig` in any text editor *before opening* the project in Android Studio and set the desired name.
If you need to change this option after you open the project in Android Studio, do the following:
@@ -274,8 +276,9 @@ go to Xcode and open the `iosApp/iosApp.xcworkspace` file, and make changes.
## Next steps
-We encourage you to further explore Compose Multiplatform and try out more projects:
+We encourage you to explore Compose Multiplatform further and try out more projects:
-* [Learn about other cases where you can use the Compose Multiplatform UI framework](https://github.com/JetBrains/compose-multiplatform)
+* [Learn about other cases where you can use the Compose Multiplatform UI framework](https://github.com/JetBrains/compose-multiplatform#readme)
+* [Create an application targeting Windows, macOS, and Linux with Compose Multiplatform for Desktop](https://github.com/JetBrains/compose-multiplatform-desktop-template#readme)
* [Complete more Compose Multiplatform tutorials](https://github.com/JetBrains/compose-multiplatform#tutorials)
* [Explore some more advanced Compose Multiplatform example projects](https://github.com/JetBrains/compose-multiplatform#examples)
\ No newline at end of file