update: import and links (#4782)

Author: danil-pavlov

docs/topics/multiplatform/native-cocoapods-dsl-reference.md

@@ -137,11 +137,11 @@ and `source` of the library, in its configuration block:
 ```kotlin
 kotlin {
     iosArm64()
+    
     cocoapods {
         version = "2.0"
         summary = "CocoaPods test library"
         homepage = "https://github.com/JetBrains/kotlin"
-
         ios.deploymentTarget = "16.0"
 
         pod("pod_dependency") {

docs/topics/multiplatform/native-cocoapods-libraries.md

@@ -38,10 +38,9 @@ version of the library, you can just omit this parameter altogether.
 
         cocoapods {
             version = "2.0"
-            ios.deploymentTarget = "16.0"
-
             summary = "CocoaPods test library"
             homepage = "https://github.com/JetBrains/kotlin"
+            ios.deploymentTarget = "16.0"
 
             pod("SDWebImage") {
                 version = "5.20.0"
@@ -81,7 +80,6 @@ import cocoapods.SDWebImage.*
             version = "2.0"
             summary = "CocoaPods test library"
             homepage = "https://github.com/JetBrains/kotlin"
-
             ios.deploymentTarget = "16.0"
 
             pod("pod_dependency") {
@@ -145,7 +143,6 @@ import cocoapods.SDWebImage.*
             version = "2.0"
             summary = "CocoaPods test library"
             homepage = "https://github.com/JetBrains/kotlin"
-
             ios.deploymentTarget = "16.0"
 
             pod("SDWebImage") {
@@ -175,7 +172,7 @@ import cocoapods.SDWebImage.*
 To use these dependencies from the Kotlin code, import the packages `cocoapods.<library-name>`:
 
 ```kotlin
-import cocoapods.Alamofire.*
+import cocoapods.SDWebImage.*
 import cocoapods.JSONModel.*
 import cocoapods.CocoaLumberjack.*
 ```
@@ -194,7 +191,6 @@ import cocoapods.CocoaLumberjack.*
             version = "2.0"
             summary = "CocoaPods test library"
             homepage = "https://github.com/JetBrains/kotlin"
-
             ios.deploymentTarget = "16.0"
 
             specRepos {
@@ -245,7 +241,6 @@ import cocoapods.example.*
             version = "2.0"
             summary = "CocoaPods test library"
             homepage = "https://github.com/JetBrains/kotlin"
-
             ios.deploymentTarget = "16.0"
 
             pod("FirebaseAuth") {
@@ -294,7 +289,6 @@ kotlin {
         version = "2.0"
         summary = "CocoaPods test library"
         homepage = "https://github.com/JetBrains/kotlin"
-
         ios.deploymentTarget = "16.0"
 
         pod("PodName") {

docs/topics/multiplatform/native-cocoapods-xcode.md

@@ -40,6 +40,7 @@ dependency by calling `pod install` manually for each Xcode project. In other ca
             summary = "CocoaPods test library"
             homepage = "https://github.com/JetBrains/kotlin"
             ios.deploymentTarget = "16.0"
+   
             pod("SDWebImage") {
                 version = "5.20.0"
             }

docs/topics/multiplatform/native-cocoapods.md

@@ -134,14 +134,14 @@ To create a project using the web wizard and configure the CocoaPods integration
    alias(libs.plugins.kotlinCocoapods)
    ```
 
-Now you are ready to use CocoaPods in your Kotlin Multiplatform project.
+Now you are ready to [configure CocoaPods in your Kotlin Multiplatform project](#configure-the-project).
 
 ### In Android Studio
 
 To create a project in Android Studio with the CocoaPods integration:
 
 1. Install the [Kotlin Multiplatform plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform) to Android Studio.
-2. In Android Studio, select  **File** | **New** | **New Project** in the menu.
+2. In Android Studio, select **File** | **New** | **New Project** in the menu.
 3. In the list of project templates, select **Kotlin Multiplatform App** and then click **Next**.
 4. Name your application and click **Next**.
 5. Choose **CocoaPods Dependency Manager** as the iOS framework distribution option.
@@ -152,11 +152,16 @@ To create a project in Android Studio with the CocoaPods integration:
 
    The plugin will automatically generate the project with the CocoaPods integration set up.
 
-## Configure existing project
+## Configure the project
 
-If you already have a project, you can add and configure the Kotlin CocoaPods Gradle plugin manually:
+To configure the Kotlin CocoaPods Gradle plugin in your multiplatform project:
 
-1. In `build.gradle(.kts)` of your project, apply the CocoaPods plugin as well as the Kotlin Multiplatform plugin:
+1. In `build.gradle(.kts)` of your project, apply the CocoaPods plugin as well as the Kotlin Multiplatform plugin.
+
+   > Skip this step if you've created your project with the [web wizard](#using-web-wizard) or
+   > the [Kotlin Multiplatform plugin for Android Studio](#in-android-studio).
+   > 
+   {style="note"}
 
     ```kotlin
     plugins {
@@ -318,8 +323,8 @@ Try these workarounds to avoid this error:
 
 1. Look through the downloaded Pod directory `[shared_module_name]/build/cocoapods/synthetic/IOS/Pods/...`
    for the `module.modulemap` file.
-2. Check the framework name inside the module, for example `SDWebImageMapKit {}`. If the framework name doesn't match the Pod
-name, specify it explicitly:
+2. Check the framework name inside the module, for example `SDWebImageMapKit {}`. If the framework name doesn't match
+   the Pod name, specify it explicitly:
 
     ```kotlin
     pod("SDWebImage/MapKit") {