Update

Author: dzienisz

android-sdk/about.mdx

@@ -17,15 +17,9 @@ For managing static translations in your repository, consider using the [Tolgee
 
 ## Overview
 
-Tolgee Mobile SDK for Android and Compose Multiplatform lets you localize Kotlin-based applications with dynamic content delivery, providing translations dynamically without needing to publish new app versions.
+Tolgee Mobile SDK for **Android** and **Compose Multiplatform** lets you localize Kotlin-based applications with **dynamic content delivery**, providing translations dynamically without needing to publish new app versions.
 
-**Supports Over‑the‑Air (OTA)** translation updates, seamless integration with Android Views, Jetpack Compose, Compose Multiplatform, and static translation fallbacks.
-
-## Why should you try it?
-
-Tolgee platform lets you ship translations and new languages faster and easier without a new app build.
-
-The platform works offline with caching, fallbacks to static translation resources when needed, and preloading critical namespaces for a smooth user experience. Additionally, Tolgee keeps UX consistent by updating the UI automatically in response to translation or locale changes. These features result in fewer untranslated or mismatched strings of text.
+**Supports Over‑the‑Air (OTA)** translation updates, seamless integration with **Android Views**, **Jetpack Compose**, **Compose Multiplatform**, and **static translation fallbacks**.
 
 ## Features
 
@@ -78,12 +72,6 @@ The platform works offline with caching, fallbacks to static translation resourc
   />
 </div>
 
-## Compatibility
-
-:::note
-To build configuration examples use Kotlin DSL (build.gradle.kts). Groovy DSL may work but is not officially supported/tested.
-:::
-
 ## Get Started
 
 Ready to integrate Tolgee into your Android project? 
@@ -94,7 +82,7 @@ Ready to integrate Tolgee into your Android project?
     emoji="🚀"
     description="Complete step-by-step setup guide with installation, modules, and implementation choices"
     links={[
-      { href: "./get-started", label: "Start Here", color: "blue" }
+      { href: "/android-sdk/get-started", label: "Start Here", color: "blue" }
     ]}
   />
 </div>

android-sdk/get-started.mdx

@@ -48,7 +48,7 @@ Follow these steps to integrate Tolgee into your Android project and start local
     emoji="🚀"
     description="Modern declarative UI with reactive translations"
     links={[
-      { href: "/android-sdk/jetpack/overview", label: "Overview", color: "blue" },
+      { href: "/android-sdk/jetpack", label: "Overview", color: "blue" },
       { href: "/android-sdk/jetpack/installation", label: "Installation", color: "green" },
       { href: "/android-sdk/jetpack/usage", label: "Usage", color: "orange" }
     ]}
@@ -99,5 +99,5 @@ After completing the setup, your app will have:
 ## Need Help?
 
 - **Manage translations collaboratively**: Connect your app to the Tolgee Platform — [Platform docs](../platform/)
-- **Troubleshooting**: Common issues and diagnostics — [Troubleshooting](./troubleshooting.mdx)
-- **Demo Apps**: Complete example implementations — [Demo Apps](./about#demo-apps)
+- **Troubleshooting**: Common issues and diagnostics — [Troubleshooting](./troubleshooting)
+- **Demo Apps**: Complete example implementations — [Demo Apps](/android-sdk#demo-apps)

android-sdk/jetpack/installation.mdx

@@ -32,6 +32,10 @@ For managing static translations, we recommend using [Tolgee CLI](https://github
 Using **Version Catalog** is recommended to keep your versions aligned, especially in bigger projects. This provides **readability, centralization, and consistency**.
 :::
 
+:::note
+To build configuration examples use Kotlin DSL (build.gradle.kts). Groovy DSL may work but is not officially supported/tested.
+:::
+
 1. Add dependency (Compose):
 
 In `gradle/libs.versions.toml` <u>add an alias for Tolgee Compose library</u>.

android-sdk/jetpack/overview.mdx

@@ -32,7 +32,7 @@ Transform your Jetpack Compose or Compose Multiplatform app with dynamic transla
     emoji="📦"
     description="Set up Tolgee Compose dependencies and configuration"
     links={[
-      { href: "./installation", label: "Install Guide", color: "blue" }
+      { href: "/android-sdk/jetpack/installation", label: "Install Guide", color: "blue" }
     ]}
   />
 
@@ -98,13 +98,13 @@ Explore our complete Jetpack Compose demo to see all features in action:
 
 ## Integration Path
 
-1. **[Quickstart](./installation)** - Add Compose-specific dependencies
+1. **[Quickstart](/android-sdk/jetpack/installation)** - Add Compose-specific dependencies
 2. **[Usage Patterns](./usage)** - Learn Compose integration patterns
-3. **[Production Setup](../production)** - Configure for deployment
+3. **[Production Setup](/android-sdk/production)** - Configure for deployment
 4. **[Troubleshooting](./troubleshooting)** - Resolve integration issues
 
 ## Need Help?
 
 - Check our **[Troubleshooting Guide](./troubleshooting)** for Compose-specific issues
 - Explore the **[Complete Demo](https://github.com/tolgee/tolgee-mobile-kotlin-sdk/tree/master/demo/examplejetpack)** for implementation examples
-- Review **[Production Guide](../production)** for deployment best practices
+- Review **[Production Guide](/android-sdk/production)** for deployment best practices

android-sdk/quickstart.mdx

@@ -32,6 +32,10 @@ The **Core module** is a Kotlin Multiplatform library that provides runtime supp
 Using **Version Catalog** is recommended to keep your versions aligned, especially in bigger projects. This provides **readability, centralization, and consistency**. 
 :::
 
+:::note
+To build configuration examples use Kotlin DSL (build.gradle.kts). Groovy DSL may work but is not officially supported/tested.
+:::
+
 1. Add dependency (Core):
 
  In `gradle/libs.versions.toml` <u>add an alias for Tolgee library</u>.

android-sdk/troubleshooting.mdx

@@ -56,7 +56,7 @@ Expect HTTP 200. For 403/404, re‑copy the prefix and check project permissions
 
 ## Useful links
 
-- Installation: [Installation](./installation.mdx)
+- Installation: [Quickstart](./quickstart.mdx)
 - Usage (Views): [Usage](./usage.mdx)
 - Jetpack Compose: [Installation](./jetpack/installation.mdx), [Usage](./jetpack/usage.mdx)
 - CLI for static strings: [Tolgee CLI](/tolgee-cli/installation)

platform/faq.mdx

@@ -32,7 +32,7 @@ Yes. Tolgee provides a native [iOS SDK](/ios-sdk) that integrates with your app
 
 Yes. Tolgee provides a native [Android SDK](/android-sdk) that integrates with your app and supports Jetpack Compose.
 
-- Get started: [Installation](/android-sdk/installation)
+- Get started: [Quickstart](/android-sdk/quickstart)
 - Use translations: [Usage](/android-sdk/usage)
 - Compose UI: [Jetpack Compose](/android-sdk/jetpack/installation)
 - File format details: [Android Resources XML](/platform/formats/android_xml)

platform/formats/android_xml.mdx

@@ -86,7 +86,7 @@ Tolgee.init {
 
 See also:
 
-- Android SDK: [Installation](/android-sdk/installation) · [Usage](/android-sdk/usage) · [Jetpack Compose](/android-sdk/jetpack/installation)
+- Android SDK: [Quickstart](/android-sdk/quickstart) · [Usage](/android-sdk/usage) · [Jetpack Compose](/android-sdk/jetpack/installation)
 
 ## Array support
 When importing data to Tolgee from the Android XML files, the array elements are converted into flat keys with

platform/getting_started/translation_content.mdx

@@ -38,8 +38,8 @@ Tolgee provides a native [iOS SDK](/ios-sdk) with a great support for SwiftUI th
 
 Tolgee also provides an [Android SDK](/android-sdk) for native Android apps, including Jetpack Compose support. Follow the Android docs to:
 
-- Install and initialize the SDK: [Installation](/android-sdk/installation)
+- Install and initialize the SDK: [Quickstart](/android-sdk/quickstart)
 - Use translations in Views and handle plurals/parameters: [Usage](/android-sdk/usage)
 - Use localized composables: [Jetpack Compose](/android-sdk/jetpack/installation)
 
-In production, configure content delivery (CDN) using the Android [Installation](/android-sdk/installation) and [Production guide](/android-sdk/production), and preload data as needed.
+In production, configure content delivery (CDN) using the Android [Quickstart](/android-sdk/quickstart) and [Production guide](/android-sdk/production), and preload data as needed.

sidebarAndroidSdk.js

@@ -1,15 +1,9 @@
 module.exports = {
   someSidebar: [
     'about',
-    {
-      type: 'category',
-      label: 'Get started',
-      link: {
-        type: 'doc',
-        id: 'get-started',
-      },
-      items: ['quickstart', 'modules'],
-    },
+    'get-started',
+    'quickstart',
+    'modules',
     'usage',
     {
       type: 'category',