docs: enhance Android SDK documentation with detailed features and usage examples

Author: dzienisz

android-sdk/about.mdx

@@ -26,36 +26,6 @@ The platform works offline with **caching**, **fallbacks**, **device-aware resou
 Tolgee gives you multiple hosting options: Cloud CDN (Cloud or self‑hosting) or your own CDN.
 :::
 
-## Features
-
-<FeatureGrid features={[
-  {
-    emoji: '🚀',
-    title: 'Over-the-air updates',
-    description: 'Update your translations without releasing a new app version',
-    colorTheme: 'blue'
-  },
-  {
-    emoji: '🔧',
-    title: 'Multiple format support',
-    description: '• <strong>Sprintf</strong> (Android SDK) formatting<br/>• <strong>ICU</strong> (Tolgee Native Flat JSON) formatting',
-    colorTheme: 'green'
-  },
-  {
-    emoji: '⚡',
-    title: 'Compose integration',
-    description: 'Full integration with Jetpack Compose and Compose Multiplatform',
-    colorTheme: 'purple'
-  },
-  {
-    emoji: '🌐',
-    title: 'Kotlin Multiplatform',
-    description: 'Designed with multiplatform support in mind',
-    colorTheme: 'orange'
-  }
-]} />
-
-
 ## Modules
 
 Tolgee Mobile SDK is split into modules so you only add what you need.
@@ -65,11 +35,27 @@ Tolgee Mobile SDK is split into modules so you only add what you need.
   - Use with traditional Android Views or any non-Compose UI.
   - Provides content delivery (CDN), key lookup, formatting (Sprintf/ICU), caching.
   - Start here if you don't use Jetpack Compose.
+
+
 - **Compose**
   - Use with Jetpack Compose or Compose Multiplatform.
   - Adds localized composables and helpers (e.g., stringResource, pluralStringResource).
   - Requires core transitively.
 
+### Features
+- **Core**
+  - **Over-the-air updates**: Update your translations without releasing a new app version.
+  - **Multiple format support**: Sprintf (Android SDK) formatting, ICU (Tolgee Native Flat JSON) formatting.
+  - **Kotlin Multiplatform**: Designed with multiplatform support in mind.
+  - **Android integration**: Seamless integration with Android resources.
+  - **Dynamic locale switching**: Change languages at runtime.
+
+ - **Compose**
+   - **Compose Integration**: Use Tolgee translations in your Compose UI with familiar APIs.
+   - **Android Resource Support**: Seamless integration with Android string resources.
+   - **Parameter Support**: Pass parameters to your translations.
+   - **Plural Support**: Handles plural forms.
+   - **Reactive Updates**: UI automatically updates when translations or locale change.
 
 ## Demo apps
 

android-sdk/quickstart.mdx

@@ -142,7 +142,26 @@ For your app to download translation files, you need to provide a CDN URL prefix
 2. Copy the full CDN URL prefix.
 3. You can use different prefixes per environment (dev/staging/prod).
 
-### Optional: Verify connectivity locally:
+:::info
+If you have a different integration setup (for example, using tolgee-cli and bundling JSON translation files in assets), the initialization may look different.
+:::
+
+### Other Platforms
+
+For non-Android platforms, initialization is similar but without the Android-specific storage provider:
+
+```kotlin
+fun initTolgee() {
+    Tolgee.init {
+        contentDelivery {
+            url = "https://cdn.tolg.ee/your-cdn-url-prefix"
+            // Create a custom storage provider for caching the latest translations from CDN if needed
+        }
+    }
+}
+```
+
+### **Optional**: Verify connectivity locally:
 
 ```bash
 curl -I "https://cdn.tolg.ee/your-cdn-url-prefix/en.json"
@@ -152,20 +171,7 @@ You should receive a 200 response.
 If you get 403 (Forbidden) or 404 (Not found), double‑check the prefix.
 
 :::tip
-Dynamic updates without republishing
-:::
-
-To receive **fresh translations without needing to publish new app versions**, wrap the base context in your Activities.
-This way, APIs like getString will use Tolgee **dynamically**.
-
-- **With wrapped context** → fresh translations from the Tolgee CDN will be provided automatically.
-
-- **Without wrapped context** → only the translations already bundled or previously cached will be available.
-
-**See the step-by-step guide in Usage.**
-
-:::info
-If you have a different integration setup (for example, using tolgee-cli and bundling JSON translation files in assets), the initialization may look different.
+Dynamic updates without republishing. See the step-by-step guide in [**Usage**](./usage.mdx).
 :::
 
 ## Next steps