docs(nav): fix sidebar nesting, dynamic language switcher, and delete translations page (#5535)

Author: jamesarich

.agent_memory/session_context.md

@@ -3,6 +3,25 @@
 # Do NOT edit or remove previous entries — stale state claims cause agent confusion.
 # Format: ## YYYY-MM-DD — <summary>
 
+## 2026-05-20 — Replaced standalone translations landing page with dynamic global header language switcher dropdown
+- Deleted redundant standalone page `docs/en/translations.md` and updated `docs/README.md` to reflect layout change.
+- Completely re-engineered `docs/_includes/language_switcher.html` to:
+  1. Dynamically parse active page paths and locales, matching default English pages with translated variants.
+  2. Bind button text to native active language names (e.g., displaying "Беларуская" instead of hardcoded "English").
+  3. Pre-verify file existence in `site.pages` to only render valid translation links, preventing any 404 errors.
+  4. Automatically hide the language switcher on English pages that do not have translations available yet.
+- Modified custom CSS styles in `docs/_includes/head_custom.html` to use `right: 0; left: auto;` layout alignment, preventing dropdown menu overflows on smaller screens.
+- Successfully built and verified live documentation pages in the browser using the browser subagent, confirming fully operational dynamic swappers.
+- Ran quality and validation checks: `./gradlew generateDocsBundle validateDocsBundle spotlessCheck detekt` (100% SUCCESSFUL).
+
+## 2026-05-20 — Fixed Jekyll documentation site left navigation nesting and sub-page visibility
+- Cleaned up redundant and brittle dynamic default scope parent settings in `docs/_config.yml`.
+- Added explicit `parent: User Guide` front-matter fields to all 17 English user guide markdown files under `docs/en/user/`.
+- Added explicit `parent: Developer Guide` front-matter fields to all 9 English developer guide markdown files under `docs/en/developer/`.
+- Run and verified Gradle documentation bundle compilation: `./gradlew generateDocsBundle validateDocsBundle` (PASSED: 672 pages).
+- Validated formatting and static analysis rules: `./gradlew spotlessApply spotlessCheck detekt` (100% green).
+- Successfully completed full baseline compilation checks with `./gradlew assembleDebug`.
+
 ## 2026-05-20 — Completely overhauled, simplified, and pushed Flatpak offline source automation
 - Completely retired the third-party `flatpak-gradle-generator` plugin and its associated complex configuration and library overrides (removed ~150 lines of boilerplate).
 - Implemented a native JVM-based custom Gradle task `GenerateFlatpakSourcesTask` inside `gradle/flatpak.gradle.kts` which walks the post-compilation Gradle cache and generates a perfectly sorted, deduplicated `flatpak-sources.json` in under 3 seconds.

docs/README.md

@@ -17,8 +17,7 @@ docs/
 │   ├── developer/                            ← Developer Guide pages
 │   ├── index.md                              ← Site home page
 │   ├── user.md                               ← User Guide nav parent
-│   ├── developer.md                          ← Developer Guide nav parent
-│   └── translations.md                       ← Translations landing page
+│   └── developer.md                          ← Developer Guide nav parent
 ├── fr-rFR/                                   ← French (Crowdin-generated)
 │   └── user/                                 ← Translated user guide
 ├── de-rDE/                                   ← German (Crowdin-generated)

docs/_config.yml

@@ -30,171 +30,169 @@ defaults:
   - scope:
       path: "en/user/"
     values:
-      parent: User Guide
       layout: default
   - scope:
       path: "en/developer/"
     values:
-      parent: Developer Guide
       layout: default
   # Locale-translated pages are excluded from main nav but still rendered.
   # They use a dedicated locale layout with a back-link to the English version.
   # Auto-generated from Android app locales (values-* resource dirs).
   - scope:
-      path: "ar"
+      path: "ar-rSA"
     values:
       layout: locale_page
-      locale: ar
+      locale: ar-rSA
       nav_exclude: true
   - scope:
-      path: "be"
+      path: "be-rBY"
     values:
       layout: locale_page
-      locale: be
+      locale: be-rBY
       nav_exclude: true
   - scope:
-      path: "bg"
+      path: "bg-rBG"
     values:
       layout: locale_page
-      locale: bg
+      locale: bg-rBG
       nav_exclude: true
   - scope:
-      path: "ca"
+      path: "ca-rES"
     values:
       layout: locale_page
-      locale: ca
+      locale: ca-rES
       nav_exclude: true
   - scope:
-      path: "cs"
+      path: "cs-rCZ"
     values:
       layout: locale_page
-      locale: cs
+      locale: cs-rCZ
       nav_exclude: true
   - scope:
-      path: "de"
+      path: "de-rDE"
     values:
       layout: locale_page
-      locale: de
+      locale: de-rDE
       nav_exclude: true
   - scope:
-      path: "el"
+      path: "el-rGR"
     values:
       layout: locale_page
-      locale: el
+      locale: el-rGR
       nav_exclude: true
   - scope:
-      path: "es"
+      path: "es-rES"
     values:
       layout: locale_page
-      locale: es
+      locale: es-rES
       nav_exclude: true
   - scope:
-      path: "et"
+      path: "et-rEE"
     values:
       layout: locale_page
-      locale: et
+      locale: et-rEE
       nav_exclude: true
   - scope:
-      path: "fi"
+      path: "fi-rFI"
     values:
       layout: locale_page
-      locale: fi
+      locale: fi-rFI
       nav_exclude: true
   - scope:
-      path: "fr"
+      path: "fr-rFR"
     values:
       layout: locale_page
-      locale: fr
+      locale: fr-rFR
       nav_exclude: true
   - scope:
-      path: "ga"
+      path: "ga-rIE"
     values:
       layout: locale_page
-      locale: ga
+      locale: ga-rIE
       nav_exclude: true
   - scope:
-      path: "gl"
+      path: "gl-rES"
     values:
       layout: locale_page
-      locale: gl
+      locale: gl-rES
       nav_exclude: true
   - scope:
-      path: "he"
+      path: "iw-rIL"
     values:
       layout: locale_page
-      locale: he
+      locale: iw-rIL
       nav_exclude: true
   - scope:
-      path: "hr"
+      path: "hr-rHR"
     values:
       layout: locale_page
-      locale: hr
+      locale: hr-rHR
       nav_exclude: true
   - scope:
-      path: "ht"
+      path: "ht-rHT"
     values:
       layout: locale_page
-      locale: ht
+      locale: ht-rHT
       nav_exclude: true
   - scope:
-      path: "hu"
+      path: "hu-rHU"
     values:
       layout: locale_page
-      locale: hu
+      locale: hu-rHU
       nav_exclude: true
   - scope:
-      path: "is"
+      path: "is-rIS"
     values:
       layout: locale_page
-      locale: is
+      locale: is-rIS
       nav_exclude: true
   - scope:
-      path: "it"
+      path: "it-rIT"
     values:
       layout: locale_page
-      locale: it
+      locale: it-rIT
       nav_exclude: true
   - scope:
-      path: "ja"
+      path: "ja-rJP"
     values:
       layout: locale_page
-      locale: ja
+      locale: ja-rJP
       nav_exclude: true
   - scope:
-      path: "ko"
+      path: "ko-rKR"
     values:
       layout: locale_page
-      locale: ko
+      locale: ko-rKR
       nav_exclude: true
   - scope:
-      path: "lt"
+      path: "lt-rLT"
     values:
       layout: locale_page
-      locale: lt
+      locale: lt-rLT
       nav_exclude: true
   - scope:
-      path: "nl"
+      path: "nl-rNL"
     values:
       layout: locale_page
-      locale: nl
+      locale: nl-rNL
       nav_exclude: true
   - scope:
-      path: "no"
+      path: "no-rNO"
     values:
       layout: locale_page
-      locale: no
+      locale: no-rNO
       nav_exclude: true
   - scope:
-      path: "pl"
+      path: "pl-rPL"
     values:
       layout: locale_page
-      locale: pl
+      locale: pl-rPL
       nav_exclude: true
   - scope:
-      path: "pt"
+      path: "pt-rPT"
     values:
       layout: locale_page
-      locale: pt
+      locale: pt-rPT
       nav_exclude: true
   - scope:
       path: "pt-rBR"
@@ -203,58 +201,64 @@ defaults:
       locale: pt-rBR
       nav_exclude: true
   - scope:
-      path: "ro"
+      path: "ro-rRO"
     values:
       layout: locale_page
-      locale: ro
+      locale: ro-rRO
       nav_exclude: true
   - scope:
-      path: "ru"
+      path: "ru-rRU"
     values:
       layout: locale_page
-      locale: ru
+      locale: ru-rRU
       nav_exclude: true
   - scope:
-      path: "sk"
+      path: "sk-rSK"
     values:
       layout: locale_page
-      locale: sk
+      locale: sk-rSK
       nav_exclude: true
   - scope:
-      path: "sl"
+      path: "sl-rSI"
     values:
       layout: locale_page
-      locale: sl
+      locale: sl-rSI
       nav_exclude: true
   - scope:
-      path: "sq"
+      path: "sq-rAL"
     values:
       layout: locale_page
-      locale: sq
+      locale: sq-rAL
       nav_exclude: true
   - scope:
-      path: "sr"
+      path: "sr-rLatn"
     values:
       layout: locale_page
-      locale: sr
+      locale: sr-rLatn
       nav_exclude: true
   - scope:
-      path: "sv"
+      path: "srp"
     values:
       layout: locale_page
-      locale: sv
+      locale: srp
       nav_exclude: true
   - scope:
-      path: "tr"
+      path: "sv-rSE"
     values:
       layout: locale_page
-      locale: tr
+      locale: sv-rSE
       nav_exclude: true
   - scope:
-      path: "uk"
+      path: "tr-rTR"
     values:
       layout: locale_page
-      locale: uk
+      locale: tr-rTR
+      nav_exclude: true
+  - scope:
+      path: "uk-rUA"
+    values:
+      layout: locale_page
+      locale: uk-rUA
       nav_exclude: true
   - scope:
       path: "zh-rCN"