docs: upgrade dependencies, minor improvements to the content (#344)

Author: andrii-bodnar

.github/workflows/docs.yml

@@ -10,12 +10,12 @@ jobs:
   build-and-deploy-docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 22
 
       - name: Install docs dependencies
         working-directory: website

website/docs/advanced-features/jetpack-compose.mdx

@@ -103,4 +103,4 @@ fun Greeting() {
 
 ### See also
 
-- [Real-Time Preview](real-time-preview.mdx)
+- [Real-Time Preview](real-time-preview)

website/docs/advanced-features/real-time-preview.mdx

@@ -43,7 +43,7 @@ import samplePreviewDisconnectJava from '!!raw-loader!../code-samples/real-time-
 :::tip Tips
 - To use the Real-Time Preview feature you still need to [wrap context](/setup#context-wrapping) for your activities.
 - To easily control the Real-Time Preview feature you could also use the [SDK Controls](/advanced-features/sdk-controls) UI widget.
-- For Jetpack Compose applications, see [Jetpack Compose Realtime Support](jetpack-compose.mdx).
+- For Jetpack Compose applications, see [Jetpack Compose Realtime Support](jetpack-compose).
 :::
 
 ### Config options

website/docs/installation.md

@@ -39,4 +39,4 @@ implementation ('com.github.crowdin.mobile-sdk-android:sdk:1.17.0') {
 
 ## See also
 
-- [Setup](setup.mdx)
+- [Setup](setup)

website/docs/intro.mdx

@@ -50,17 +50,6 @@ Translators can instantly preview translations they are making in Crowdin on the
 
 Project owner and managers can make screenshots right within the app version where this component is enabled. Screenshots will automatically appear in the project with tagged source strings.
 
-## Bundles
-
-Bundles allow you to generate resource files from your project strings. You can upload strings to Crowdin in any format (e.g. spreadsheet file) or create keys using the Figma plugin. Then use bundles to generate resource files to be used in your mobile or web application in any format.
-
-By default, you can choose from the following three formats: Android XML, iOS Strings, and XLIFF. You can add more target file formats by installing respective applications from the [Crowdin Store](https://store.crowdin.com/tags/string-exporter).
-
-For more details, visit Knowledge Base:
-
-- [Bundles in OTA Content Delivery (crowdin.com)](https://support.crowdin.com/bundles/#bundles-in-ota-content-delivery)
-- [Bundles in OTA Content Delivery (Crowdin Enterprise)](https://support.crowdin.com/enterprise/bundles/#bundles-in-ota-content-delivery)
-
 ## See also
 
 - [Installation](installation)

website/docs/setup.mdx

@@ -4,26 +4,26 @@ import CodeBlock from '@theme/CodeBlock';
 
 # Setup
 
-To configure Android SDK integration you need to:
+To configure Android SDK integration, you need to:
 
 - Upload your localization files to Crowdin. If you have existing translations, you can upload them as well. You can use one of the following options:
     - [Crowdin CLI](https://crowdin.github.io/crowdin-cli/)
     - [Android Studio Plugin](https://store.crowdin.com/android-studio)
     - [Crowdin GitHub Action](https://github.com/marketplace/actions/crowdin-action)
     - [and more](https://support.crowdin.com/uploading-files/)
-- Set up Distribution in Crowdin.
+- Set up a distribution in Crowdin.
 - Set up SDK and enable Over-The-Air Content Delivery feature in your project.
 
-**Distribution** is a CDN vault that mirrors the translated content of your project and is required for integration with Android app.
+**Distribution** is a CDN vault that mirrors your project's translated content and is required for Android app integration.
 
-- [Creating a distribution in crowdin.com](https://support.crowdin.com/content-delivery/)
-- [Creating a distribution in Crowdin Enterprise](https://support.crowdin.com/enterprise/content-delivery/)
+- [Creating a distribution in Crowdin](https://support.crowdin.com/cdn-distributions/)
+- [Creating a distribution in Crowdin Enterprise](https://support.crowdin.com/enterprise/cdn-distributions/)
 
 :::info
-- By default, the translation downloading happens **asynchronously** after launching the app. The downloaded translations will be used after the next launch of the app or Activity re-render. Otherwise, the [previously cached translations](/cache) will be used (or local translations if a cache does not exist).
-- The CDN feature does not update the localization files. if you want to add new translations to the localization files you need to do it yourself.
-- Once SDK receives the translations, it's stored on the device as application files for further sessions to minimize requests the next time the app starts. Storage time can be configured using `withUpdateInterval` option.
-- CDN caches all the translation in release for up to 1 hour and even when new translations are released in Crowdin, CDN may return it with a delay.
+- By default, translation download happens **asynchronously** after app launch. Downloaded translations are applied after the next app launch or activity re-render. Otherwise, [previously cached translations](/cache) are used (or bundled local translations if a cache does not exist).
+- The CDN feature does not update your localization files. If you want to add new translations to localization files, update them separately.
+- Once the SDK receives translations, they are stored on the device as application files for future sessions to minimize requests. Storage time can be configured using the `withUpdateInterval` option.
+- CDN caches released translations for up to 1 hour, so newly released translations in Crowdin may be returned with a delay.
 - To display a string, Crowdin will try to find it in the dynamic strings (from the CDN) and use the bundled version as a fallback. In other words, only the newly provided strings will be overridden and the bundled version will be used for the rest.
 :::
 
@@ -179,4 +179,3 @@ Otherwise, new resources are applied when the activity is restarted.
 - [Real-Time Preview](advanced-features/real-time-preview)
 - [Screenshots](advanced-features/screenshots)
 - [Programmatic String Access](guides/programmatic-strings)
-

website/docusaurus.config.ts

@@ -14,7 +14,11 @@ const config: Config = {
   projectName: 'mobile-sdk-android',
 
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'warn',
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
+  },
 
   i18n: {
     defaultLocale: 'en',
@@ -27,7 +31,7 @@ const config: Config = {
       ({
         docs: {
           routeBasePath: '/',
-          sidebarPath: require.resolve('./sidebars.js'),
+          sidebarPath: require.resolve('./sidebars.ts'),
           editUrl: 'https://github.com/crowdin/mobile-sdk-android/tree/master/website/',
         },
         theme: {
@@ -64,6 +68,9 @@ const config: Config = {
           },
         ],
       },
+      colorMode: {
+        respectPrefersColorScheme: true,
+      },
       footer: {
         style: 'dark',
         links: [