Skip to content

refactor(strings): optimize string resources for Crowdin quota and streamline documentation guides - #399

Merged
D4vidDf merged 3 commits into
dev/0_6_0from
docs/update-design-guides-links
Sep 27, 2026
Merged

D4vidDf merged 3 commits into
dev/0_6_0from
docs/update-design-guides-links

Conversation

@D4vidDf

@D4vidDf D4vidDf commented Sep 27, 2026

Copy link
Copy Markdown
Owner

Summary

This PR addresses Crowdin hosted word quota limits (bringing active hosted words comfortably under the 60,000 free tier limit) by removing duplicate keys, condensing verbose in-app guide copies, marking developer/mockup strings as non-translatable, and consolidating the Design Screen documentation guides into three primary section cards.


Key Changes

1. Crowdin String Quota Optimization

  • Source Translatable Word Count: Reduced translatable words in values/strings.xml from 5,440+ words down to 3,893 words (~1,540 words saved in source, translating to over 20,000+ fewer hosted words on Crowdin across 14–15 target locales).
  • String Consolidation & Deduplication: Replaced repetitive action/status keys (save, cancel, close, done, active, search, etc.) across 28+ Kotlin screens and XML layouts with unified, reusable strings.
  • Marked Developer Mockups Non-Translatable: Added translatable="false" to all template preview mockups (island_template_sample_*), raw technical formats, and developer diagnostics.
  • Removed Dead / Legacy Strings: Deleted 170+ unused legacy string resources across all 20+ locale directories (values-*/strings.xml).

2. Streamlined Documentation & Guides

  • Design Screen Section Cards: Replaced the long list of individual guide links with three primary global documentation section cards:
  • Translator Editor Bottom Sheets: Replaced heavy, multi-paragraph guide sheets (ProgressGuideSheet, ActionGuideSheet, TranslatorBehaviorGuideSheet, TranslatorPillGuideSheet) with compact, reusable DesignManagerHelpSheet redirect dialogs pointing to official documentation.
  • Spanish Localizations (es-ES, es-419): Updated and synchronized missing translations in both values-es-rES and values-es-rEM.

3. Website Documentation Reference

  • Generated REMOVED_STRINGS_DOCUMENTATION.md documenting:
    • All original in-app tutorial and guide copies (button order, progress extraction, compact pill symmetry, priority systems) for easy reference when updating website guides.
    • A catalog of all consolidated, deleted, and condensed strings.

Verification

  • Run ./gradlew assembleDebug — Build passes cleanly (BUILD SUCCESSFUL).
  • Verified all string resource references and navigation callbacks resolve properly.

- Add an "Apps" section header to the Active and Library pages to visually separate application lists from system content.
- Refactor `DesignManagerHelpSheet` into a generic, reusable bottom sheet that displays a brief description and a primary button redirecting to online documentation, replacing the previous multi-card explanation layout.
- Expand the Guides section in the Design screen with new documentation links (Customization, Design Hub, Custom Designs, Widgets, System Apps, Permanent Island, Inline Reply, Advanced) and update `DocumentationUrls`.
- Drop `ca-rES` and `gl-rES` locales, and update English and Spanish string resources for the new documentation links and help sheets.
…th documentation links

- Replace hardcoded tutorial bottom sheets in the Custom Translator editor (`ProgressGuideSheet`, `ActionGuideSheet`, `TranslatorBehaviorGuideSheet`, `TranslatorPillGuideSheet`) with a unified `DesignManagerHelpSheet` that redirects to the official online documentation.
- Consolidate duplicate string resources across all translations by reusing generic strings (e.g., "Save", "All", "Done", "Active", "Settings", "Search").
- Drop unused and redundant string resources from all localization files to reduce bloat.
- Use AndroidX `createBitmap` extension in `SystemUpdateSettingsScreen`.
- Remove unused `LocalContext` in `ThemeInstallerActivity`.
…ories

- DesignScreen: reduces the guides list by grouping individual topics (Design Hub, Theme Creator, Custom Translators, Custom Designs, Widgets, System Apps, Smart Actions, Permanent Island, Inline Reply) into two main items: Customization and Features.
- DocumentationUrls: adds the new `FEATURES_DOCS` endpoint.
- Strings: removes redundant specific guide strings and adds consolidated descriptions for the new categories in English, es-rES, and es-rEM.
@D4vidDf D4vidDf self-assigned this Sep 27, 2026
@D4vidDf D4vidDf added the enhancement New feature or request label Sep 27, 2026
@D4vidDf
D4vidDf merged commit dcc5155 into dev/0_6_0 Sep 27, 2026
2 checks passed
@D4vidDf
D4vidDf deleted the docs/update-design-guides-links branch September 27, 2026 14:16
@github-actions

Copy link
Copy Markdown

📱 Debug APK Ready for Testing

The debug APK for commit d54e1c6 has been built and is ready:

📦 Android Installation Note: GitHub Actions artifacts are downloaded as a .zip archive. Extract the zip to access and install app-debug.apk.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant