docs: additional localization examples

packages/stream_chat_localizations/README.md

@@ -15,7 +15,11 @@
 - [Chat UI Kit](https://getstream.io/chat/ui-kit/)
 - [UI Docs](https://getstream.io/chat/docs/sdk/flutter/stream_chat_flutter/introduction/)
 
-This package provides localized strings for the stream chat widgets for many languages.
+## What is Localization?
+
+If you deploy your app to users who speak another language, you'll need to internationalize (localize) it. That means you need to write the app in a way that makes it possible to localize values like text and layouts for each language or locale that the app supports. For more information, see the [Flutter documentation](https://flutter.dev/docs/development/accessibility-and-localization/**internationalization**).
+
+What this package allows you to do is to provide localized strings for the Stream chat widgets. For example, depending on the application locale, the Stream Chat widgets will display the appropriate language. The locale will be set automatically, based on system preferences, or you could set it programmatically in your app. The package supports several different languages, with more to be added. The package allows you to override any supported language or add a new language that isn't supported.
 
 ### Changelog
 

packages/stream_chat_localizations/example/README.md

@@ -1,2 +1,27 @@
 # Stream Chat Persistence Example
-Please see `lib/` for example code. 
+Please see `lib/` for example code.
+
+## Setting a language
+The application language can be changed through system preferences or programmatically.
+
+### System Preferences
+The application locale can be changed by changing the language for your device or emulator within the device's system preferences.
+
+[iOS change language](https://support.apple.com/en-us/HT204031)
+
+[Android change language](https://support.google.com/websearch/answer/3333234?co=GENIE.Platform%3DAndroid&hl=en)
+
+Note that the language needs to be supported in your application to work.
+
+### Programmatically
+You can also set the locale programmatically in your Flutter application without changing the device's language.
+
+```dart
+return MaterialApp(
+ ...
+ locale: const Locale('fr'),
+ ...
+);
+```
+
+There are many ways that this can be set for additional control. For information and examples, see this [Stack Overflow post](https://stackoverflow.com/questions/49441212/flutter-multi-lingual-application-how-to-override-the-locale).

packages/stream_chat_localizations/example/lib/main.dart

@@ -76,6 +76,8 @@ class MyApp extends StatelessWidget {
         ],
         // Add GlobalStreamChatLocalizations.delegates
         localizationsDelegates: GlobalStreamChatLocalizations.delegates,
+        // Programatically set the locale (this is a global change)
+        locale: const Locale('fr'),
         builder: (context, widget) => StreamChat(
           client: client,
           child: widget,