From 61987d0fabef1ca8edc20e6f8483f8f6b61b6cb2 Mon Sep 17 00:00:00 2001
From: Karl Heinz Struggl <karl.struggl@sentry.io>
Date: Fri, 10 Jan 2025 16:35:56 +0100
Subject: [PATCH 1/5] moves kmp as sub-guide into kotlin

---
 .../kotlin-multiplatform/configuration/draining.mdx |   0
 .../configuration/environments.mdx                  |   0
 .../configuration/filtering.mdx                     |   0
 .../kotlin-multiplatform/configuration/gradle.mdx   |   0
 .../kotlin-multiplatform/configuration/index.mdx    |   0
 .../kotlin-multiplatform/configuration/options.mdx  |   0
 .../kotlin-multiplatform/configuration/releases.mdx |   0
 .../data-management/apple-privacy-manifest.mdx      |   0
 .../kotlin-multiplatform/data-management/index.mdx  |   0
 .../data-management/sensitive-data/index.mdx        |   0
 .../kotlin-multiplatform/debug-symbols/index.mdx    |   0
 .../enriching-events/attachments/index.mdx          |   0
 .../enriching-events/breadcrumbs/index.mdx          |   0
 .../enriching-events/context/index.mdx              |   0
 .../enriching-events/identify-user/index.mdx        |   0
 .../kotlin-multiplatform/enriching-events/index.mdx |   0
 .../enriching-events/scopes/index.mdx               |   0
 .../screenshots/img/screenshot-list-example.png     | Bin
 .../screenshots/img/screenshot-thumbnail.png        | Bin
 .../enriching-events/screenshots/index.mdx          |   0
 .../enriching-events/tags/index.mdx                 |   0
 .../enriching-events/viewhierarchy/index.mdx        |   0
 .../guides}/kotlin-multiplatform/features/index.mdx |   0
 .../guides}/kotlin-multiplatform/index.mdx          |   6 ++++--
 .../initialization-strategies.mdx                   |   0
 .../kotlin-multiplatform/manual-setup/index.mdx     |   0
 .../kotlin-multiplatform/native-access-sdk.mdx      |   0
 .../kotlin-multiplatform/troubleshooting.mdx        |   0
 .../guides}/kotlin-multiplatform/usage/index.mdx    |   0
 .../kotlin-multiplatform/usage/set-level/index.mdx  |   0
 .../kotlin-multiplatform/user-feedback/index.mdx    |   0
 31 files changed, 4 insertions(+), 2 deletions(-)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/draining.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/environments.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/filtering.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/gradle.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/options.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/configuration/releases.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/data-management/apple-privacy-manifest.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/data-management/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/data-management/sensitive-data/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/debug-symbols/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/attachments/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/breadcrumbs/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/context/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/identify-user/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/scopes/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-list-example.png (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-thumbnail.png (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/screenshots/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/tags/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/enriching-events/viewhierarchy/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/features/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/index.mdx (93%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/initialization-strategies.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/manual-setup/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/native-access-sdk.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/troubleshooting.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/usage/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/usage/set-level/index.mdx (100%)
 rename docs/platforms/{ => kotlin/guides}/kotlin-multiplatform/user-feedback/index.mdx (100%)

diff --git a/docs/platforms/kotlin-multiplatform/configuration/draining.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/draining.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/draining.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/draining.mdx
diff --git a/docs/platforms/kotlin-multiplatform/configuration/environments.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/environments.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/environments.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/environments.mdx
diff --git a/docs/platforms/kotlin-multiplatform/configuration/filtering.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/filtering.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/filtering.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/filtering.mdx
diff --git a/docs/platforms/kotlin-multiplatform/configuration/gradle.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/gradle.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/gradle.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/gradle.mdx
diff --git a/docs/platforms/kotlin-multiplatform/configuration/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/configuration/options.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/options.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/options.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/options.mdx
diff --git a/docs/platforms/kotlin-multiplatform/configuration/releases.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/releases.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/configuration/releases.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/configuration/releases.mdx
diff --git a/docs/platforms/kotlin-multiplatform/data-management/apple-privacy-manifest.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/data-management/apple-privacy-manifest.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/data-management/apple-privacy-manifest.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/data-management/apple-privacy-manifest.mdx
diff --git a/docs/platforms/kotlin-multiplatform/data-management/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/data-management/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/data-management/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/data-management/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/data-management/sensitive-data/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/data-management/sensitive-data/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/data-management/sensitive-data/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/data-management/sensitive-data/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/debug-symbols/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/debug-symbols/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/debug-symbols/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/attachments/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/attachments/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/attachments/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/attachments/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/breadcrumbs/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/breadcrumbs/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/breadcrumbs/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/breadcrumbs/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/context/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/context/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/context/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/context/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/identify-user/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/identify-user/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/identify-user/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/identify-user/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/scopes/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/scopes/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/scopes/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/scopes/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-list-example.png b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-list-example.png
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-list-example.png
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-list-example.png
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-thumbnail.png b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-thumbnail.png
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-thumbnail.png
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/screenshots/img/screenshot-thumbnail.png
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/screenshots/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/screenshots/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/screenshots/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/screenshots/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/tags/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/tags/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/tags/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/tags/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/enriching-events/viewhierarchy/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/viewhierarchy/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/enriching-events/viewhierarchy/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/enriching-events/viewhierarchy/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/features/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/features/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/index.mdx
similarity index 93%
rename from docs/platforms/kotlin-multiplatform/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/index.mdx
index 702eb821aff83..44b251c96c808 100644
--- a/docs/platforms/kotlin-multiplatform/index.mdx
+++ b/docs/platforms/kotlin/guides/kotlin-multiplatform/index.mdx
@@ -6,14 +6,16 @@ sdk: sentry.kotlin.kmp
 categories:
   - mobile
   - desktop
-keywords: ["kotlin"]
+keywords:
+  - kotlin
+  - kmp
 ---
 
 <PlatformContent includePath="getting-started-primer" />
 
 ## Install
 
-Sentry captures data by using an SDK within your application’s runtime.
+Sentry captures data by using an SDK within your application's runtime.
 
 <PlatformContent includePath="getting-started-install" />
 
diff --git a/docs/platforms/kotlin-multiplatform/initialization-strategies.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/initialization-strategies.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/initialization-strategies.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/initialization-strategies.mdx
diff --git a/docs/platforms/kotlin-multiplatform/manual-setup/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/manual-setup/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/native-access-sdk.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/native-access-sdk.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/native-access-sdk.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/native-access-sdk.mdx
diff --git a/docs/platforms/kotlin-multiplatform/troubleshooting.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/troubleshooting.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/troubleshooting.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/troubleshooting.mdx
diff --git a/docs/platforms/kotlin-multiplatform/usage/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/usage/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/usage/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/usage/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/usage/set-level/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/usage/set-level/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/usage/set-level/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/usage/set-level/index.mdx
diff --git a/docs/platforms/kotlin-multiplatform/user-feedback/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/user-feedback/index.mdx
similarity index 100%
rename from docs/platforms/kotlin-multiplatform/user-feedback/index.mdx
rename to docs/platforms/kotlin/guides/kotlin-multiplatform/user-feedback/index.mdx

From 5d5057a28a345cfc488db241728ce3df14c5570b Mon Sep 17 00:00:00 2001
From: Karl Heinz Struggl <karl.struggl@sentry.io>
Date: Fri, 10 Jan 2025 16:39:44 +0100
Subject: [PATCH 2/5] updates Kotlin main page for KMP

---
 docs/platforms/kotlin/index.mdx | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/docs/platforms/kotlin/index.mdx b/docs/platforms/kotlin/index.mdx
index feb7bc2cf449b..a1e927c319950 100644
--- a/docs/platforms/kotlin/index.mdx
+++ b/docs/platforms/kotlin/index.mdx
@@ -2,8 +2,6 @@
 title: Kotlin
 caseStyle: camelCase
 supportLevel: production
-sdk: sentry.java
-fallbackPlatform: java
 categories:
   - mobile
   - desktop
@@ -12,13 +10,13 @@ keywords:
   - kotlin
 ---
 
-Sentry supports JVM related use of Kotlin with our [Java](/platforms/java) SDK, and, for Android applications, with our [Android](/platforms/android) platform.
+Sentry supports JVM related use of Kotlin with the [Java](/platforms/java) SDK. For native Android applications, use the [Android](/platforms/android) SDK. If you use KMP, the [Kotlin Multiplatform](/platforms/kotlin/guides/kotlin-multiplatform/) SDK provides the best integration.
 
 Select your platform to get started:
 
 - [Java](/platforms/java)
 - [Android](/platforms/android)
-- [Kotlin Multiplatform](/platforms/kotlin-multiplatform)
+- [Kotlin Multiplatform](/platforms/kotlin/guides/kotlin-multiplatform/)
 
 ## Kotlin Extensions
 

From 0d1789501a5a6b4e9424a9b052418e7a73c37b40 Mon Sep 17 00:00:00 2001
From: Karl Heinz Struggl <karl.struggl@sentry.io>
Date: Fri, 10 Jan 2025 16:40:23 +0100
Subject: [PATCH 3/5] renames KMP includes to account for being a guide

---
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 .../{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} | 0
 28 files changed, 0 insertions(+), 0 deletions(-)
 rename platform-includes/capture-error/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/capture-message/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/configuration/before-send/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/configuration/config-intro/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/configuration/drain-example/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/add-attachment/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/attach-screenshots/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/attach-viewhierarchy/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/attachment-init-with-bytes/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/attachment-init-with-path/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/attachment-max-size/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/attachment-upload/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/breadcrumbs/before-breadcrumb/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/breadcrumbs/breadcrumbs-example/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/scopes/configure-scope/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/scopes/scope-callback-param/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/set-context/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/set-tag/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/set-user/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/enriching-events/unset-user/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/getting-started-config/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/getting-started-install/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/getting-started-primer/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/getting-started-verify/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/set-environment/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/set-level/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/set-release/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)
 rename platform-includes/user-feedback/sdk-api-example/{kotlin-multiplatform.mdx => kotlin.kotlin-multiplatform.mdx} (100%)

diff --git a/platform-includes/capture-error/kotlin-multiplatform.mdx b/platform-includes/capture-error/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/capture-error/kotlin-multiplatform.mdx
rename to platform-includes/capture-error/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/capture-message/kotlin-multiplatform.mdx b/platform-includes/capture-message/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/capture-message/kotlin-multiplatform.mdx
rename to platform-includes/capture-message/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/configuration/before-send/kotlin-multiplatform.mdx b/platform-includes/configuration/before-send/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/configuration/before-send/kotlin-multiplatform.mdx
rename to platform-includes/configuration/before-send/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/configuration/config-intro/kotlin-multiplatform.mdx b/platform-includes/configuration/config-intro/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/configuration/config-intro/kotlin-multiplatform.mdx
rename to platform-includes/configuration/config-intro/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/configuration/drain-example/kotlin-multiplatform.mdx b/platform-includes/configuration/drain-example/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/configuration/drain-example/kotlin-multiplatform.mdx
rename to platform-includes/configuration/drain-example/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/add-attachment/kotlin-multiplatform.mdx b/platform-includes/enriching-events/add-attachment/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/add-attachment/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/add-attachment/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/attach-screenshots/kotlin-multiplatform.mdx b/platform-includes/enriching-events/attach-screenshots/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/attach-screenshots/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/attach-screenshots/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/attach-viewhierarchy/kotlin-multiplatform.mdx b/platform-includes/enriching-events/attach-viewhierarchy/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/attach-viewhierarchy/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/attach-viewhierarchy/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/attachment-init-with-bytes/kotlin-multiplatform.mdx b/platform-includes/enriching-events/attachment-init-with-bytes/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/attachment-init-with-bytes/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/attachment-init-with-bytes/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/attachment-init-with-path/kotlin-multiplatform.mdx b/platform-includes/enriching-events/attachment-init-with-path/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/attachment-init-with-path/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/attachment-init-with-path/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/attachment-max-size/kotlin-multiplatform.mdx b/platform-includes/enriching-events/attachment-max-size/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/attachment-max-size/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/attachment-max-size/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/attachment-upload/kotlin-multiplatform.mdx b/platform-includes/enriching-events/attachment-upload/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/attachment-upload/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/attachment-upload/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/breadcrumbs/before-breadcrumb/kotlin-multiplatform.mdx b/platform-includes/enriching-events/breadcrumbs/before-breadcrumb/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/breadcrumbs/before-breadcrumb/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/breadcrumbs/before-breadcrumb/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/breadcrumbs/breadcrumbs-example/kotlin-multiplatform.mdx b/platform-includes/enriching-events/breadcrumbs/breadcrumbs-example/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/breadcrumbs/breadcrumbs-example/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/breadcrumbs/breadcrumbs-example/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/scopes/configure-scope/kotlin-multiplatform.mdx b/platform-includes/enriching-events/scopes/configure-scope/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/scopes/configure-scope/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/scopes/configure-scope/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/scopes/scope-callback-param/kotlin-multiplatform.mdx b/platform-includes/enriching-events/scopes/scope-callback-param/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/scopes/scope-callback-param/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/scopes/scope-callback-param/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/set-context/kotlin-multiplatform.mdx b/platform-includes/enriching-events/set-context/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/set-context/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/set-context/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/set-tag/kotlin-multiplatform.mdx b/platform-includes/enriching-events/set-tag/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/set-tag/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/set-tag/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/set-user/kotlin-multiplatform.mdx b/platform-includes/enriching-events/set-user/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/set-user/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/set-user/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/enriching-events/unset-user/kotlin-multiplatform.mdx b/platform-includes/enriching-events/unset-user/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/enriching-events/unset-user/kotlin-multiplatform.mdx
rename to platform-includes/enriching-events/unset-user/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/getting-started-config/kotlin-multiplatform.mdx b/platform-includes/getting-started-config/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/getting-started-config/kotlin-multiplatform.mdx
rename to platform-includes/getting-started-config/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/getting-started-install/kotlin-multiplatform.mdx b/platform-includes/getting-started-install/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/getting-started-install/kotlin-multiplatform.mdx
rename to platform-includes/getting-started-install/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/getting-started-primer/kotlin-multiplatform.mdx b/platform-includes/getting-started-primer/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/getting-started-primer/kotlin-multiplatform.mdx
rename to platform-includes/getting-started-primer/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/getting-started-verify/kotlin-multiplatform.mdx b/platform-includes/getting-started-verify/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/getting-started-verify/kotlin-multiplatform.mdx
rename to platform-includes/getting-started-verify/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/set-environment/kotlin-multiplatform.mdx b/platform-includes/set-environment/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/set-environment/kotlin-multiplatform.mdx
rename to platform-includes/set-environment/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/set-level/kotlin-multiplatform.mdx b/platform-includes/set-level/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/set-level/kotlin-multiplatform.mdx
rename to platform-includes/set-level/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/set-release/kotlin-multiplatform.mdx b/platform-includes/set-release/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/set-release/kotlin-multiplatform.mdx
rename to platform-includes/set-release/kotlin.kotlin-multiplatform.mdx
diff --git a/platform-includes/user-feedback/sdk-api-example/kotlin-multiplatform.mdx b/platform-includes/user-feedback/sdk-api-example/kotlin.kotlin-multiplatform.mdx
similarity index 100%
rename from platform-includes/user-feedback/sdk-api-example/kotlin-multiplatform.mdx
rename to platform-includes/user-feedback/sdk-api-example/kotlin.kotlin-multiplatform.mdx

From 7ad2c7b93ed43904f40b09f83558239473da4f77 Mon Sep 17 00:00:00 2001
From: Karl Heinz Struggl <karl.struggl@sentry.io>
Date: Fri, 10 Jan 2025 16:55:26 +0100
Subject: [PATCH 4/5] adds redirect for kmp main page

---
 src/middleware.ts | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/middleware.ts b/src/middleware.ts
index 7deefdd8ac336..1d466b3814269 100644
--- a/src/middleware.ts
+++ b/src/middleware.ts
@@ -3363,6 +3363,10 @@ const USER_DOCS_REDIRECTS: Redirect[] = [
     from: '/clients/cordova/',
     to: '/platforms/javascript/guides/cordova/',
   },
+  {
+    from: '/platforms/kotlin-multiplatform/',
+    to: '/platforms/kotlin/guides/kotlin-multiplatform/',
+  },
 ];
 
 const DEVELOPER_DOCS_REDIRECTS: Redirect[] = [

From d70de55072c46633ae01048dc9d9734a48b9c9bc Mon Sep 17 00:00:00 2001
From: Karl Heinz Struggl <karl.struggl@sentry.io>
Date: Fri, 10 Jan 2025 17:14:23 +0100
Subject: [PATCH 5/5] fixes existing links to KMP

---
 .../kotlin/guides/kotlin-multiplatform/features/index.mdx     | 2 +-
 .../kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx | 4 ++--
 .../kotlin/guides/kotlin-multiplatform/troubleshooting.mdx    | 4 ++--
 docs/product/user-feedback/setup.mdx                          | 2 +-
 .../getting-started-primer/kotlin.kotlin-multiplatform.mdx    | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx
index 5b1d7d65f46f6..d804b576a9ac8 100644
--- a/docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx
+++ b/docs/platforms/kotlin/guides/kotlin-multiplatform/features/index.mdx
@@ -14,7 +14,7 @@ Because the SDK provides a unified API for all supported platforms directly leve
 <Note>
 Some functionality may not be available in the shared Kotlin Multiplatform layer yet. You may have to use the native SDKs directly, or write your own platform-specific code.
 
-To access the native SDK init options, use the [Native Platform Options initialization](/platforms/kotlin-multiplatform/initialization-strategies/#native-platform-options).
+To access the native SDK init options, use the [Native Platform Options initialization](/platforms/kotlin/guides/kotlin-multiplatform/initialization-strategies/#native-platform-options).
 </Note>
 
 ## Supported Platforms
diff --git a/docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx
index a0014584fd416..5411be1ff4b82 100644
--- a/docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx
+++ b/docs/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/index.mdx
@@ -4,7 +4,7 @@ sidebar_order: 3
 description: "Learn how to manually set up the SDK."
 ---
 
-If you can't (or prefer not to) use the [gradle plugin](/platforms/kotlin-multiplatform/#install), you can follow the instructions below to configure your application manually.
+If you can't (or prefer not to) use the [gradle plugin](/platforms/kotlin/guides/kotlin-multiplatform/#install), you can follow the instructions below to configure your application manually.
 
 ## Install
 
@@ -92,6 +92,6 @@ If you already use SPM or prefer it over other package managers on Apple platfor
 
 In order to install the Sentry Kotlin Multiplatform SDK, you need to use Cocoapods and Swift Package Manager simultaneously, which might seem unconventional at first, especially if you're accustomed to using SPM for all your dependencies. However, you can achieve a smooth integration by using the Kotlin Cocoapods plugin specifically for compiling and building the shared framework. You can then continue to manage all other dependencies with SPM as usual.
 
-Follow the steps for our primary installation method [Cocoapods](/platforms/kotlin-multiplatform/manual-setup/#install) to install the Sentry Kotlin Multiplatform SDK.
+Follow the steps for our primary installation method [Cocoapods](/platforms/kotlin/guides/kotlin-multiplatform/manual-setup/#install) to install the Sentry Kotlin Multiplatform SDK.
 
 After you've consumed the shared framework in your application via Cocoapods, you can continue with SPM for other dependencies without disrupting your existing workflow.
diff --git a/docs/platforms/kotlin/guides/kotlin-multiplatform/troubleshooting.mdx b/docs/platforms/kotlin/guides/kotlin-multiplatform/troubleshooting.mdx
index 52dfe3a814405..a8b70ae41917f 100644
--- a/docs/platforms/kotlin/guides/kotlin-multiplatform/troubleshooting.mdx
+++ b/docs/platforms/kotlin/guides/kotlin-multiplatform/troubleshooting.mdx
@@ -10,7 +10,7 @@ If you need additional help, [ask on GitHub](https://github.com/getsentry/sentry
 
 ## "Missing API declaration" after App Store review
 
-Starting May 1, 2024, Apple requires all apps submitted to the App Store to provide a list of privacy-related APIs they use, including the reasons under which they use it. If you received an email from Apple with the message "ITMS-91053: Missing API declaration", your app doesn't fulfill the requirements. To solve this, follow our [Apple Privacy Manifest](/platforms/kotlin-multiplatform/data-management/apple-privacy-manifest) guide.
+Starting May 1, 2024, Apple requires all apps submitted to the App Store to provide a list of privacy-related APIs they use, including the reasons under which they use it. If you received an email from Apple with the message "ITMS-91053: Missing API declaration", your app doesn't fulfill the requirements. To solve this, follow our [Apple Privacy Manifest](/platforms/kotlin/guides/kotlin-multiplatform/data-management/apple-privacy-manifest) guide.
 
 ## Tests Not Working
 
@@ -22,7 +22,7 @@ This example shows you how to fix the issue for the iOS simulator target, but th
 
 **1. Download the Sentry xcframework**
 
-- Choose the Sentry Cocoa release based on the version specified in the [version compatibility table](/platforms/kotlin-multiplatform/#cocoa-sdk-version-compatibility-table)
+- Choose the Sentry Cocoa release based on the version specified in the [version compatibility table](/platforms/kotlin/guides/kotlin-multiplatform/#cocoa-sdk-version-compatibility-table)
 - Download the `Sentry.xcframework.zip` on [GitHub](https://github.com/getsentry/sentry-cocoa/releases), and unzip it.
 
 **2. Create a frameworks directory and insert `Sentry.framework`**
diff --git a/docs/product/user-feedback/setup.mdx b/docs/product/user-feedback/setup.mdx
index 26e63cba07de4..c47697b82fe66 100644
--- a/docs/product/user-feedback/setup.mdx
+++ b/docs/product/user-feedback/setup.mdx
@@ -46,7 +46,7 @@ This allows you to connect your own user interface with Sentry's Crash-Reports.
 - [.NET](/platforms/dotnet/user-feedback/)
 - [Flutter](/platforms/flutter/user-feedback/)
 - [Java](/platforms/java/user-feedback/)
-- [Kotlin](/platforms/kotlin-multiplatform/user-feedback/)
+- [Kotlin](/platforms/kotlin/guides/kotlin-multiplatform/user-feedback/)
 - [Node.JS](/platforms/javascript/guides/node/user-feedback/)
 - [PHP](/platforms/php/user-feedback/)
 - [React Native](/platforms/react-native/user-feedback/)
diff --git a/platform-includes/getting-started-primer/kotlin.kotlin-multiplatform.mdx b/platform-includes/getting-started-primer/kotlin.kotlin-multiplatform.mdx
index afcf156dccc4c..975677de27eda 100644
--- a/platform-includes/getting-started-primer/kotlin.kotlin-multiplatform.mdx
+++ b/platform-includes/getting-started-primer/kotlin.kotlin-multiplatform.mdx
@@ -14,5 +14,5 @@ Xcode 16 support starts with Sentry Cocoa SDK version `8.36.0` or higher.
 
 <Note>
 Starting May 1, 2024, Apple requires all apps submitted to the App Store to provide a list of privacy-related APIs they use. Use Sentry Cocoa SDK version `8.25.0` or higher to ensure compliance with these requirements.
-Follow our [Apple Privacy Manifest](/platforms/kotlin-multiplatform/data-management/apple-privacy-manifest) guide to learn more.
+Follow our [Apple Privacy Manifest](/platforms/kotlin/guides/kotlin-multiplatform/data-management/apple-privacy-manifest) guide to learn more.
 </Note>