comments suggestions

Author: irodotos7

example/android/javalib/5-R8/build.mill

@@ -1,11 +1,21 @@
 // R8 is a code shrinker and obfuscator for Android applications. Is designed to optimize the size of the APK
 // while maintaining the functionality of the app.
 // When using R8, you can configure the rules for code shrinking and obfuscation in a ProGuard configuration file.
+// R8 relies on ProGuard rules files to adjust its default behavior and gain a better understanding of your app’s structure,
+// such as identifying the classes that act as entry points. While you can modify some of these rules files,
+// certain rules may be automatically generated by compile-time tools (like AAPT2) or inherited from your app’s library dependencies.
 // You need 2 files on the root of your project:
-// 1. proguard-rules.pro: This file contains the rules for R8 to follow when shrinking and obfuscating the code.
-// 2. test-proguard-rules.pro: This file contains the rules for R8 to follow when shrinking and obfuscating the unit and instrumented tests.
-// You can also override the default Proguard files by using override def proguardConfigs: T[Seq[PathRef]]
-// See Also: app/proguard-rules.pro & app/test-proguard-rules.pro
+//
+// * proguard-rules.pro: This file contains the rules for R8 to follow when shrinking and obfuscating the code.
+//
+// * test-proguard-rules.pro: This file contains the rules for R8 to follow when shrinking and obfuscating the unit and instrumented tests.
+//
+// You can also override the default Proguard files by using `override def proguardConfigs: T[Seq[PathRef]]`
+// More informations about the R8 in general and about the Proguard rules files can be found in the links below:
+//
+// https://developer.android.com/build/shrink-code
+//
+// https://www.guardsquare.com/manual/configuration/usage
 package build
 
 import mill._, javalib._
@@ -86,9 +96,9 @@ object app extends AndroidAppModule { // <2>
 
 */
 
-// R8 will run automatically when you run the androidReleaseInstall task.
-// If you want to create the APK without R8, you can use the androidApk task to create the not-optimized APK. You can also
-// run the andoidInstall task that will automaticaly run the androidApk and also install it in the emulator.
-// The androidReleaseInstall task will install the optimized APK on the emulator.
+// R8 will run automatically when you run the `androidReleaseInstall` task.
+// If you want to create the APK without R8, you can use the `androidApk` task to create the not-optimized APK. You can also
+// run the `andoidInstall` task that will automaticaly run the `androidApk` and also install it in the emulator.
+// The `androidReleaseInstall` task will install the optimized APK on the emulator.
 // So first you need to create the emulator and start it.
-// After the emulator is started, you can run the androidReleaseInstall task and see the app in the emulator.
+// After the emulator is started, you can run the `androidReleaseInstall` task and see the app in the emulator.