feat: bit more docs within demos

Author: Anty0

demo/exampleandroid/src/main/java/io/tolgee/demo/exampleandroid/MainActivity.kt

@@ -16,6 +16,8 @@ class MainActivity : ComponentActivity() {
   val tolgee = Tolgee.instance
 
   override fun attachBaseContext(newBase: Context?) {
+    // Wrapping base context will make sure getString calls will use tolgee
+    // even for instances which cannot be replaced automatically by the compiler
     super.attachBaseContext(TolgeeContextWrapper.wrap(newBase))
   }
 
@@ -24,12 +26,14 @@ class MainActivity : ComponentActivity() {
 
     lifecycleScope.launch {
       tolgee.changeFlow.collect {
+        // we want to reload activity after a language change
         recreate()
       }
     }
 
     setContentView(R.layout.activity_main)
 
+    // Make sure the app title stays updated
     setTitle(R.string.app_name)
 
     val name = findViewById<TextView>(R.id.app_name_text)
@@ -41,6 +45,7 @@ class MainActivity : ComponentActivity() {
     val buttonFr = findViewById<Button>(R.id.button_fr)
     val buttonCs = findViewById<Button>(R.id.button_cs)
 
+    // Update texts within the app with translated ones
     name.text = getString(R.string.app_name)
     basic.text = getString(R.string.description)
     parameter.text = getString(R.string.percentage_placeholder, "87")
@@ -63,6 +68,10 @@ class MainActivity : ComponentActivity() {
 
   override fun onStart() {
     super.onStart()
+
+    // Make sure the translations are loaded
+    // This function will initiate translations fetching in the background and
+    // will trigger changeFlow whenever updated translations are available
     Tolgee.instance.preload(this)
   }
 }

demo/examplejetpack/src/main/java/io/tolgee/demo/examplejetpack/MainActivity.kt

@@ -56,6 +56,7 @@ class MainActivity : ComponentActivity() {
 
 @Composable
 fun BasicText(modifier: Modifier = Modifier) {
+  // Use tolgee version of stringResource composable
   Text(
     text = stringResource(R.string.description),
     modifier = modifier
@@ -64,6 +65,7 @@ fun BasicText(modifier: Modifier = Modifier) {
 
 @Composable
 fun ParametrizedText(name: String, modifier: Modifier = Modifier) {
+  // Passing parameters for the stringResource is supported
   Text(
     text = stringResource(R.string.percentage_placeholder, name),
     modifier = modifier
@@ -72,6 +74,7 @@ fun ParametrizedText(name: String, modifier: Modifier = Modifier) {
 
 @Composable
 fun PluralText(count: Int, param: Int, modifier: Modifier = Modifier) {
+  // Plurals are also supported
   Text(
     text = pluralStringResource(R.plurals.plr_test_placeholder_2, count, param, count, "Plurals"),
     modifier = modifier

demo/multiplatform-compose/src/commonMain/kotlin/io/tolgee/demo/compose/App.kt

@@ -19,15 +19,31 @@ fun App() {
 
     MaterialTheme {
         Column {
+            // Use tolgee version of stringResource composable
+            // (or alternatively enable tolgee compiler plugin which will convert the calls automatically)
             Text(text = stringResource(Res.string.description))
-            Text(text = stringResource(Res.string.percentage_placeholder))
+            Text(text = stringResource(Res.string.percentage_placeholder, "87"))
             Button(
                 onClick = {
-                    tolgee.setLocale("en-US")
+                    tolgee.setLocale("en")
                 }
             ) {
                 Text(text = "English")
             }
+            Button(
+                onClick = {
+                    tolgee.setLocale("fr")
+                }
+            ) {
+                Text(text = "Français")
+            }
+            Button(
+                onClick = {
+                    tolgee.setLocale("cs")
+                }
+            ) {
+                Text(text = "Čeština")
+            }
         }
     }
 }