chore: make the IDE recommendation clearer (JetBrains#300)

Author: zamulla

mpd.tree

@@ -9,14 +9,6 @@
 		<toc-element topic="faq.md"/>
 		<toc-element topic="kotlin-multiplatform-roadmap.md" toc-title="KMP roadmap"/>
 	</toc-element>
-	<toc-element toc-title="What's new in Kotlin Multiplatform">
-		<toc-element toc-title="What's new in Compose Multiplatform">
-			<toc-element topic="whats-new-compose-170.md"/>
-			<toc-element accepts-web-file-names="whats-new-compose-eap.html" topic="whats-new-compose-1610.md"/>
-			<toc-element accepts-web-file-names="whats-new-compose-1-6-0.html" topic="whats-new-compose.md"/>
-		</toc-element>
-		<toc-element topic="whats-new-fleet-1-31.md"/>
-	</toc-element>
 	<toc-element accepts-web-file-names="compose-multiplatform-setup.html" topic="multiplatform-setup.md"/>
 	<toc-element toc-title="Create an app with shared logic and native UI">
 		<toc-element toc-title="1. Create your Kotlin Multiplatform app" accepts-web-file-names="multiplatform-getting-started.html" topic="multiplatform-create-first-app.md"/>
@@ -45,6 +37,11 @@
 	<toc-element toc-title="Samples" topic="multiplatform-samples.md"/>
 	<toc-element toc-title="Compose Multiplatform UI framework">
 		<toc-element toc-title="Why Compose Multiplatform" href="https://www.jetbrains.com/lp/compose-multiplatform/"/>
+		<toc-element toc-title="What's new in Compose Multiplatform">
+			<toc-element topic="whats-new-compose-170.md"/>
+			<toc-element accepts-web-file-names="whats-new-compose-eap.html" topic="whats-new-compose-1610.md"/>
+			<toc-element accepts-web-file-names="whats-new-compose-1-6-0.html" topic="whats-new-compose.md"/>
+		</toc-element>
 		<toc-element topic="compose-multiplatform-and-jetpack-compose.md"/>
 		<toc-element toc-title="Multiplatform resources">
 			<toc-element accepts-web-file-names="compose-images-resources.html" topic="compose-multiplatform-resources.md"/>

topics/journal/multiplatform-reasons-to-try.md

@@ -193,7 +193,7 @@ When working with Kotlin Multiplatform projects, you have powerful tooling at yo
 * **Xcode**. Apple's IDE can be used to create the iOS part of Kotlin Multiplatform apps.
   Xcode is the standard for iOS app development, offering a plethora of tools for coding, debugging, and configuration.
   However, Xcode is Mac only.
-* **Fleet**. A new technology from JetBrains. 
+* **Fleet**. A new IDE from JetBrains. 
   [Fleet](https://www.jetbrains.com/fleet/) combines the convenience of a lightweight code editor with its 
   Smart Mode and is built using the IntelliJ Platform on the backend.
   Fleet supports multiple programming languages, including Kotlin and Swift, and provides cross-language features like navigation,

topics/overview/faq.md

@@ -25,8 +25,8 @@ about [supported platforms](supported-platforms.md).
 
 ### In which IDE should I work on my cross-platform app?
 
-We recommend using JetBrains Fleet code editor or Android Studio IDE, depending on your project needs and expectations.
-Learn more about which one to choose in [Recommended IDEs and code editors](recommended-ides.md).
+We recommend using the Android Studio IDE to work with Kotlin Multiplatform projects.
+Read more about available alternatives in [Recommended IDEs and code editors](recommended-ides.md).
 
 ### How do I create a new Kotlin Multiplatform project?
 
@@ -112,6 +112,8 @@ simply runs on Jetpack Compose.
 Other platforms targeted by Compose Multiplatform may have implementation details under the hood that differ from those
 of Jetpack Compose on Android, but they still provide you with the same APIs.
 
+For details, see the [overview of the frameworks' interrelation](compose-multiplatform-and-jetpack-compose.md).
+
 ### Between which platforms can I share my UI?
 
 We want you to have the option to share your UI between any combination of popular platforms – Android, iOS, desktop
@@ -239,9 +241,6 @@ working with the DOM in Kotlin/JS, and it's not intended for sharing UIs across
 Yes, we're acutely aware of the current challenges with multiplatform tooling and are actively working on enhancements
 in several areas.
 
-We've already launched previews of the [Kotlin Multiplatform support in Fleet](fleet.md).
-Try it yourself and leave feedback!
-
 ### Are you going to provide a Swift interop?
 
 Yes. We're currently investigating various approaches to provide direct interoperability with Swift, with a focus on

topics/tools/recommended-ides.md

@@ -1,10 +1,17 @@
 [//]: # (title: Recommended IDEs and code editors)
 
+## Android Studio IDE
+
+[Android Studio](https://developer.android.com/studio) is the more stable solution,
+although its support for Kotlin Multiplatform is still limited.
+
+With Android Studio, you can also install a [Kotlin Multiplatform plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile)
+that provides basic launching and debugging capabilities for iOS apps.
+
 ## JetBrains Fleet code editor
 
-For the best Kotlin Multiplatform development experience, we recommend using [JetBrains Fleet](https://www.jetbrains.com/fleet/).  
-Fleet is a code editor for any language that can transform into a more powerful tool for development.
-It is designed to be smart and focused on core development workflows (the edit-build-run loop), 
+[JetBrains Fleet](https://www.jetbrains.com/fleet/) is a code editor for any language that can transform into a more powerful tool for development.
+It is designed to be smart and focused on core development workflows (the edit-build-run loop),
 AI-capable, and ready for remote development and collaboration.
 
 Fleet supports testing and debugging your code on all target platforms. You can also navigate between Kotlin
@@ -17,14 +24,6 @@ See the [Use Fleet for Multiplatform development](fleet.md) tutorial to get star
 >
 {style="note"}
 
-## Android Studio IDE
-
-As a more stable solution, you can use [Android Studio](https://developer.android.com/studio),
-although its support for Kotlin Multiplatform is limited.
-
-With Android Studio, you can also install a [special plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile)
-that provides minimal launching and debugging capabilities for iOS apps.
-
 ## Other IDEs and code editors
 
 If basic Kotlin Multiplatform support is enough for you, you can use any IDE that supports Kotlin, including [IntelliJ IDEA](https://www.jetbrains.com/idea/).