docs: fix broken relative links and rename recommendations to production guide

dzienisz · dzienisz · commit 0dd54ac1906e · 2025-09-25T12:42:37.000+02:00
diff --git a/android-sdk/core-module/quickstart.mdx b/android-sdk/core-module/quickstart.mdx
@@ -168,7 +168,7 @@ Dynamic updates without republishing. See the step-by-step guide in [**Usage**](
 
 ## Next steps
 
-- Not sure which artifact to use? See ['overview`](./about.mdx)
+- Not sure which artifact to use? See [overview](../about.mdx)
 - Learn how to fetch and render translations in Views: [`Usage`](./usage.mdx)
-- Using Compose? Start here: [`Jetpack Installation`](./jetpack/installation.mdx)
+- Using Compose? Start here: [Jetpack Installation](../jetpack/installation.mdx)
 - Having issues? Check [`Troubleshooting`](./troubleshooting.mdx)
diff --git a/android-sdk/core-module/troubleshooting.mdx b/android-sdk/core-module/troubleshooting.mdx
@@ -93,5 +93,5 @@ See also: [Android XML format](/platform/formats/android_xml) · [Tolgee Univers
 - Usage (Views): [Usage](./usage.mdx)
 - For complete examples of how to use the Tolgee Core module, check out the demo projects:
   Traditional Android Views example - https://github.com/tolgee/tolgee-mobile-kotlin-sdk/tree/master/demo/exampleandroid
-- Jetpack Compose: [Installation](./jetpack/installation.mdx), [Usage](./jetpack/usage.mdx)
+- Jetpack Compose: [Installation](../jetpack/installation.mdx), [Usage](../jetpack/usage.mdx)
 - CLI for static strings: [Tolgee CLI](/tolgee-cli/installation)
diff --git a/android-sdk/core-module/usage.mdx b/android-sdk/core-module/usage.mdx
@@ -136,7 +136,7 @@ val textFlow = tolgee.tFlow(context, R.string.string_key)
 ```
 
 :::note
-In Compose, use `collectAsState()` function for a more idiomatic integration. See more in [**Jetpack Compose Usage**](./jetpack/usage.mdx).
+In Compose, use `collectAsState()` function for a more idiomatic integration. See more in [**Jetpack Compose Usage**](../jetpack/usage.mdx).
 :::
 
 ## Plurals
@@ -245,6 +245,6 @@ As mentioned in
 
 ## Next Steps
 
-- **Using Compose?** Continue with [Jetpack Compose Usage](./jetpack/usage.mdx)
-- **Production deployment?** See [Production Guide](./production.mdx)
+- **Using Compose?** Continue with [Jetpack Compose Usage](../jetpack/usage.mdx)
+- **Production deployment?** See [Production Guide](/android-sdk/production)
 - **Having issues?** Check [Troubleshooting](./troubleshooting.mdx)
diff --git a/android-sdk/get-started.mdx b/android-sdk/get-started.mdx
@@ -18,13 +18,13 @@ Follow these steps to integrate Tolgee into your Android project and start local
     title="Quickstart"
     emoji="📦"
     description="Set up dependencies and network security configuration"
-    links={[{ href: './quickstart', label: 'Quickstart Guide', color: 'blue' }]}
+    links={[{ href: './core-module/quickstart', label: 'Quickstart Guide', color: 'blue' }]}
   />
 </div>
 
 ## Integration Path
 
-### 1. **[Quickstart](./quickstart)** - Add Tolgee SDK to your project
+### 1. **[Quickstart](./core-module/quickstart)** - Add Tolgee SDK to your project
 
 ### 2. **Choose your implementation**
 
@@ -34,7 +34,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', label: 'Overview', color: 'blue' },
+      { href: '/android-sdk/jetpack/get-started', label: 'Overview', color: 'blue' },
       {
         href: '/android-sdk/jetpack/installation',
         label: 'Installation',
@@ -49,7 +49,7 @@ Follow these steps to integrate Tolgee into your Android project and start local
   title="Android Views"
   emoji="📱"
   description="Traditional Android UI with dynamic translations"
-  links={[{ href: './usage', label: 'Usage Guide', color: 'purple' }]}
+  links={[{ href: './core-module/usage', label: 'Usage Guide', color: 'purple' }]}
 />
 
   <SystemCard
@@ -85,12 +85,12 @@ After completing the setup, your app will have:
     title="Production Guide"
     emoji="🚀"
     description="Over‑the‑Air (OTA) updates, caching, formatting, and testing for production apps"
-    links={[{ href: './production', label: 'Production Setup', color: 'blue' }]}
+    links={[{ href: '/android-sdk/production', label: 'Production Setup', color: 'blue' }]}
   />
 </div>
 
 ## Need Help?
 
 - **Manage translations collaboratively**: Connect your app to the Tolgee Platform — [Platform docs](../platform/)
-- **Troubleshooting**: Common issues and diagnostics — [Troubleshooting](./troubleshooting)
+- **Troubleshooting**: Common issues and diagnostics — [Troubleshooting](./core-module/troubleshooting)
 - **Demo Apps**: Complete example implementations — [Demo Apps](/android-sdk#demo-apps)
diff --git a/android-sdk/jetpack/installation.mdx b/android-sdk/jetpack/installation.mdx
@@ -63,7 +63,7 @@ dependencies {
 ```
 
 :::note
-If you use **traditional Android Views**, see the Core variant: [Core Quickstart](/android-sdk/quickstart)
+If you use **traditional Android Views**, see the Core variant: [Core Quickstart](/android-sdk/core-module/quickstart)
 :::
 
 2. (If needed) Ensure repositories include Maven Central in `settings.gradle.kts` or `build.gradle.kts`:
diff --git a/android-sdk/jetpack/overview.mdx b/android-sdk/jetpack/overview.mdx
diff --git a/android-sdk/jetpack/troubleshooting.mdx b/android-sdk/jetpack/troubleshooting.mdx
@@ -89,7 +89,7 @@ See also: [Android XML format](/platform/formats/android_xml) · [Tolgee Univers
 
 ## Useful links
 
-- Views troubleshooting: [/android-sdk/troubleshooting](/android-sdk/troubleshooting)
+- Views troubleshooting: [Core Module Troubleshooting](/android-sdk/core-module/troubleshooting)
 - Quickstart (Compose): [Installation](./installation.mdx)
 - Usage (Compose): [Usage](./usage.mdx)
 - For complete examples of how to use the Tolgee Compose module, check out the demo projects:
diff --git a/android-sdk/jetpack/usage.mdx b/android-sdk/jetpack/usage.mdx
@@ -164,6 +164,6 @@ Handy for **observing locale changes** in real time, **keeping track of current
 
 ## Next Steps
 
-- **Using traditional Views?** See [Core Module Usage](/android-sdk/usage)
-- **Production deployment?** Check [Production Guide](../production.mdx)
+- **Using traditional Views?** See [Core Module Usage](/android-sdk/core-module/usage)
+- **Production deployment?** Check [Production Guide](/android-sdk/production)
 - **Having issues?** See [Troubleshooting](./troubleshooting.mdx)
diff --git a/android-sdk/production.mdx b/android-sdk/production.mdx
@@ -1,10 +1,10 @@
 ---
-id: reccomendations
-title: Reccomendations
+id: production
+title: Production
 description: OTA updates, caching, formatting, and deployment tips for shipping to production.
 ---
 
-# Reccomendations
+# Production
 
 This guide summarizes recommendations for using Tolgee Android SDK in production.
 
diff --git a/platform/faq.mdx b/platform/faq.mdx
@@ -32,8 +32,8 @@ 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: [Quickstart](/android-sdk/quickstart)
-- Use translations: [Usage](/android-sdk/usage)
+- Get started: [Quickstart](/android-sdk/core-module/quickstart)
+- Use translations: [Usage](/android-sdk/core-module/usage)
 - Compose UI: [Jetpack Compose](/android-sdk/jetpack/installation)
 - File format details: [Android Resources XML](/platform/formats/android_xml)
 
diff --git a/platform/formats/android_xml.mdx b/platform/formats/android_xml.mdx
@@ -86,7 +86,7 @@ Tolgee.init {
 
 See also:
 
-- Android SDK: [Quickstart](/android-sdk/quickstart) · [Usage](/android-sdk/usage) · [Jetpack Compose](/android-sdk/jetpack/installation)
+- Android SDK: [Quickstart](/android-sdk/core-module/quickstart) · [Usage](/android-sdk/core-module/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
diff --git a/platform/getting_started/translation_content.mdx b/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: [Quickstart](/android-sdk/quickstart)
-- Use translations in Views and handle plurals/parameters: [Usage](/android-sdk/usage)
+- Install and initialize the SDK: [Quickstart](/android-sdk/core-module/quickstart)
+- Use translations in Views and handle plurals/parameters: [Usage](/android-sdk/core-module/usage)
 - Use localized composables: [Jetpack Compose](/android-sdk/jetpack/installation)
 
-In production, configure content delivery (CDN) using the Android [Quickstart](/android-sdk/quickstart) and [Production guide](/android-sdk/production), and preload data as needed.
+In production, configure content delivery (CDN) using the Android [Quickstart](/android-sdk/core-module/quickstart) and [Production guide](/android-sdk/production), and preload data as needed.
diff --git a/sidebarAndroidSdk.js b/sidebarAndroidSdk.js
@@ -11,7 +11,6 @@ module.exports = {
         'core-module/troubleshooting',
       ],
     },
-
     {
       type: 'category',
       label: 'Jetpack Compose',
@@ -21,6 +20,6 @@ module.exports = {
         'jetpack/troubleshooting',
       ],
     },
-    'reccomendations',
+    'production',
   ],
 };
