From 0add6e3b5c130c005ad92f1c81d96038cf5ccf10 Mon Sep 17 00:00:00 2001
From: minikin <djminikin@gmail.com>
Date: Tue, 21 Nov 2023 14:46:41 +0100
Subject: [PATCH] wip

---
 catalyst_voices/README.md                     |  2 +-
 .../catalyst_voices_localization/README.md    | 30 ++++++++++++++++---
 cspell.json                                   |  5 ++--
 3 files changed, 30 insertions(+), 7 deletions(-)

diff --git a/catalyst_voices/README.md b/catalyst_voices/README.md
index cd33fe617dd..66a173c130f 100644
--- a/catalyst_voices/README.md
+++ b/catalyst_voices/README.md
@@ -75,4 +75,4 @@ genhtml coverage/lcov.info -o coverage/
 
 # Open Coverage Report
 open coverage/index.html
-```
\ No newline at end of file
+```
diff --git a/catalyst_voices/packages/catalyst_voices_localization/README.md b/catalyst_voices/packages/catalyst_voices_localization/README.md
index a474aeb5a60..8e73864e5c6 100644
--- a/catalyst_voices/packages/catalyst_voices_localization/README.md
+++ b/catalyst_voices/packages/catalyst_voices_localization/README.md
@@ -4,6 +4,8 @@ This package contains the localization files for the Catalyst Voices app.
 
 * [Catalyst Voices Localization](#catalyst-voices-localization)
   * [Working with Translations](#working-with-translations)
+  * [Creating New Locale Messages](#creating-new-locale-messages)
+  * [Generating VoicesLocalizations](#generating-voiceslocalizations)
     * [Adding Strings](#adding-strings)
     * [Adding Supported Locales](#adding-supported-locales)
     * [Adding Translations](#adding-translations)
@@ -11,7 +13,30 @@ This package contains the localization files for the Catalyst Voices app.
 ## Working with Translations
 
 This project relies on [flutter_localizations](https://github.com/flutter/flutter/tree/master/packages/flutter_localizations).
-It follows the [official internationalization guide for Flutter][flutter-intl-guide].
+It follows the
+[official internationalization guide for Flutter](https://docs.flutter.dev/development/accessibility-and-localization/internationalization).
+
+## Creating New Locale Messages
+
+To add new strings for localization, modify `intl_en.arb`,
+which this project uses as its template.
+
+New entries must adhere to the format below:
+
+```arb
+  "dartGetterVariableName": "english translation of the message",
+  "@dartGetterVariableName": {
+    "description": "description for use by the localizations delegate."
+  },
+```
+
+Here, `dartGetterVariableName` represents the Dart method/property name utilized in your localizations delegate.
+
+Once you've updated `intl_en.arb` with the new message, regenerate the `VoicesLocalizations` delegate to enable
+immediate use of the English message in your application code through the localizations delegate,
+bypassing the need to wait for translation completion.
+
+## Generating VoicesLocalizations
 
 ### Adding Strings
 
@@ -113,6 +138,3 @@ Update the `CFBundleLocalizations` array in the `Info.plist` at `ios/Runner/Info
 ```shell
 flutter gen-l10n
 ```
-
-
-[flutter-intl-guide]: https://docs.flutter.dev/development/accessibility-and-localization/internationalization
\ No newline at end of file
diff --git a/cspell.json b/cspell.json
index 979023996dd..363ea0cab83 100644
--- a/cspell.json
+++ b/cspell.json
@@ -215,7 +215,7 @@
         //.config/dictionaries/cspell/sv/cspell-ext.json
         //.config/dictionaries/cspell/tr_TR/cspell-ext.json
         //.config/dictionaries/cspell/uk_UA/cspell-ext.json
-        //.config/dictionaries/cspell/vi_VN/cspell-ext.json        
+        //.config/dictionaries/cspell/vi_VN/cspell-ext.json
     ],
     "ignorePaths": [
         ".config/dictionaries/**",
@@ -233,6 +233,7 @@
         "**/historic_data/**/*.json",
         "**/test_data/**/*.sql",
         "styles.min.css",
-        "web-components.min.js"
+        "web-components.min.js",
+        "**/generated/**"
     ]
 }
\ No newline at end of file