Create 0006-only-translated-strings-in-language-file.md

docs/adr/0006-only-translated-strings-in-language-file.md

@@ -0,0 +1,47 @@
+# Only translated strings in language file
+
+## Context and Problem Statement
+
+JabRef has translation files `JabRef_it.properties`, ...
+There are translated and unstranslated strings.
+Which ones should be in the translation file?
+
+## Decision Drivers
+
+* Translators should find new strings to translate easily
+* New strings to translate should be written into `JabRef_en.properties` to enable translation by the translators
+* Crowdin should be kept as translation platform, because 1) it is much easier for the translators than the GitHub workflow and 2) it is free for OSS projects.
+
+## Considered Options
+
+* Only translated strings in language file
+* Translated and untranslated strings in language file, have value the untranslated string to indicate untranslated
+* Translated and untranslated strings in language file, have empty to indicate untranslated
+
+## Decision Outcome
+
+Chosen option: "Only translated strings in language file", because comes out best (see below.
+
+## Pros and Cons of the Options
+
+### Only translated strings in language file
+
+* Good, because Crowdin supports it
+* Bad, because translators need tooling to see untranslated strings
+* Bad, because issues with FXML (https://github.com/JabRef/jabref/issues/3796)
+
+### Translated and untranslated strings in language file, have value the untranslated string to indicate untranslated
+
+* Good, because no issues with FXML
+* Good, because Crowin supports it
+* Bad, because untranslated strings cannot be identified easily in latin languages
+
+### Translated and untranslated strings in language file, have empty to indicate untranslated
+
+* Good, because untranslated strings can be identified easily
+* Good, because works with FMXL (?)
+* Bad, because Crowdin does not support it
+
+## Links
+
+* Related to [ADR-0001](0001-use-crowdin-for-translations.md).

docs/adr/index.md

@@ -1,3 +1,4 @@
+
 # Architectural Decision Log
 
 This log lists the architectural decisions for JabRef.
@@ -10,6 +11,7 @@ This log lists the architectural decisions for JabRef.
 - [ADR-0003](0003-use-gradle-as-build-tool.md) - Use Gradle as build tool
 - [ADR-0004](0004-use-mariadb-connector.md) - Use MariaDB Connector
 - [ADR-0005](0005-fully-support-utf8-only-for-latex-files.md) - Fully Support UTF-8 Only For LaTeX Files
+- [ADR-0006](0006-only-translated-strings-in-language-file.md) - Only translated strings in language file
 
 <!-- adrlogstop -->