Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Documentation Sub-Issue: Synchronize String Resources Across All Languages

Aperta
#33 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Ferma
Stack tecnologico
android

Direzione di ricerca

Inizia verificando app/src/main/res/values* rispetto a app/src/main/res/values/strings.xml, quindi esegui lo strumento di rilevamento in scripts/TranslationStringTools/ ed esamina i relativi report. Esamina il codebase alla ricerca di stringhe UI hardcoded e definisci l’ambito delle lingue attive prima di apportare modifiche. Il lavoro è completo quando tutte le risorse delle lingue attive hanno chiavi corrispondenti, i report mostrano una copertura del 100% e il processo di traduzione è documentato e applicato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation help wanted priority: low translation

Ensure that all language string resources are always complete and fully aligned with the default English strings (values/strings.xml).
All supported languages must:

  • Contain exactly the same string keys
  • Stay in sync with any newly added or modified strings
  • Never fall back to English due to missing entries

Source of Truth

File: app/src/main/res/values/strings.xml (English / Default)

All other language files must be kept in sync with this file.

Automated String Detection Tool

A tool for detecting missing and inconsistent strings is now available in the repository:

  • Location: scripts/TranslationStringTools/
  • Reports Output: scripts/TranslationStringTools/reports/

The tool automatically compares all language files against the English source and generates reports showing:

  • Missing string keys per language
  • Coverage percentages
  • Outdated / potentially incorrect translations
  • Unused or obsolete keys

Language Status Tracking

Every language must be kept complete and up to date.

Language Folder Status Coverage Last Updated App Version
English (default) values ✅ 100% 2026-01-20 v1.0.25
German values-de ✅ 95% 2026-01-22 v1.0.25
Spanish values-es ✅ 94.5% 2026-01-22 v1.0.25
Chinese (Simplified) values-zh ✅ 95.7% 2026-01-22 v1.0.25
French values-fr ⬜ — YYYY-MM-DD vX.Y.Z
Portuguese values-pt ⬜ — YYYY-MM-DD vX.Y.Z
Russian values-ru ⬜ — YYYY-MM-DD vX.Y.Z
Japanese values-ja ⬜ — YYYY-MM-DD vX.Y.Z
Arabic values-ar ⬜ — YYYY-MM-DD vX.Y.Z
Hindi values-hi ⬜ — YYYY-MM-DD vX.Y.Z
Korean values-ko ⬜ — YYYY-MM-DD vX.Y.Z
Italian values-it ⬜ — YYYY-MM-DD vX.Y.Z
Turkish values-tr ⬜ — YYYY-MM-DD vX.Y.Z
Dutch values-nl ⬜ — YYYY-MM-DD vX.Y.Z
Polish values-pl ⬜ — YYYY-MM-DD vX.Y.Z
Indonesian values-in ⬜ — YYYY-MM-DD vX.Y.Z
Vietnamese values-vi ⬜ — YYYY-MM-DD vX.Y.Z
Thai values-th ⬜ — YYYY-MM-DD vX.Y.Z
Ukrainian values-uk ⬜ — YYYY-MM-DD vX.Y.Z
Chinese (Traditional) values-zh-rTW ⬜ — YYYY-MM-DD vX.Y.Z
Czech values-cs ⬜ — YYYY-MM-DD vX.Y.Z
Greek values-el ⬜ — YYYY-MM-DD vX.Y.Z
Swedish values-sv ⬜ — YYYY-MM-DD vX.Y.Z
Norwegian values-no ⬜ — YYYY-MM-DD vX.Y.Z
Danish values-da ⬜ — YYYY-MM-DD vX.Y.Z
Finnish values-fi ⬜ — YYYY-MM-DD vX.Y.Z

Legend:

  • ✅ = folder exists and is (nearly) complete
  • ⬜ = not yet added / incomplete / needs review

Tasks

Repository Status Check
  • Audit all app/src/main/res/values* folders
  • Document which language folders already exist
  • Identify languages that need to be created from scratch
String Consistency

Compare every values-XX/strings.xml against values/strings.xml:

  • Detect missing keys
  • Identify outdated translations
  • Find unused / obsolete keys
Codebase Audit
  • Remove all hardcoded UI strings
  • Ensure every piece of UI text uses string resources
Process Definition

Rule:
Every new or modified string must be added / updated in all languages.
Missing translations must be clearly marked (e.g. with TODO comments or @string/missing_... placeholders).

Automation
  • Run the detection tool from scripts/TranslationStringTools/ regularly
  • Review generated reports in scripts/TranslationStringTools/reports/
  • Optional: Add CI check / warning for translations below 100% coverage

Definition of Done

  • All language files contain all string keys from the default English file
  • No silent fallbacks to English due to missing resources
  • The update process is documented and actively enforced
  • The detection tool reports 100% coverage for all active languages
Lingua principale
Kotlin
Stelle
41
Fork
4
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di arn-c0de/InteractiveChecklists

Tutte le issue di arn-c0de/InteractiveChecklists

Issue simili

Altre issue su Kotlin

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.