updated documentation style

Author: Catherine22

AAD-Preparation/app/build.gradle

@@ -79,7 +79,7 @@ android {
         resultsDir "$rootDir/test-results"
         reportDir "$rootDir/test-reports"
         unitTests {
-            // Your unit tests can then access compiled versions of your resources, allowing the tests to run more quickly and accurately.
+            // Your unit tests can then access compiled versions of your resources, letting the tests run more quickly and accurately.
 //            includeAndroidResources = true
         }
     }

AAD-Preparation/app/proguard-rules.pro

@@ -17,7 +17,7 @@
 #-keepattributes SourceFile,LineNumberTable
 
 # If you keep the line number information, uncomment this to
-# hide the original source file name.
+# hide the original source filename.
 #-renamesourcefileattribute SourceFile
 
 -keep com.catherine.materialdesignapp.listeners.ProguardIgnored

AAD-Preparation/app/src/main/java/com/catherine/materialdesignapp/activities/BaseActivity.java

@@ -98,7 +98,7 @@ protected void onResume() {
      */
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
-        // Inflate the menu; this adds items to the action bar if it is present.
+        // Inflate the menu; this adds items to the app bar if it is present.
         getMenuInflater().inflate(R.menu.main_menu, menu);
 
         Storage storage = new Storage(this);

AAD-Preparation/app/src/main/java/com/catherine/materialdesignapp/activities/CursorLoaderActivity.java

@@ -453,7 +453,7 @@ class CallLogs {
          */
         static final int FEATURES_HD_CALL = 1 << 2;
         /**
-         * Call was WIFI call.
+         * Call was WI-FI call.
          */
         static final int FEATURES_WIFI = 1 << 3;
         /**

AAD-Preparation/app/src/main/java/com/catherine/materialdesignapp/activities/DynamicDeliveryActivity.java

@@ -251,7 +251,7 @@ private void onStateUpdate(SplitInstallSessionState state) {
             case SplitInstallSessionStatus.REQUIRES_USER_CONFIRMATION:
                 /*
                   This may occur when attempting to download a sufficiently large module.
-                  In order to see this, the application has to be uploaded to the Play Store.
+                  To see this, the application has to be uploaded to the Play Store.
                   Then features can be requested until the confirmation path is triggered.
                  */
                 Log.d(TAG, "startConfirmationDialogForResult");

AAD-Preparation/app/src/main/java/com/catherine/materialdesignapp/activities/SearchableSongsActivity.java

@@ -133,7 +133,7 @@ private void handleIntent(Intent intent) {
 
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
-        // Inflate the menu; this adds items to the action bar if it is present.
+        // Inflate the menu; this adds items to the app bar if it is present.
         getMenuInflater().inflate(R.menu.searchable_menu, menu);
 
         SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);

AAD-Preparation/app/src/main/java/com/catherine/materialdesignapp/activities/UIComponentsActivity.java

@@ -100,7 +100,7 @@ private void initComponent(Bundle savedInstanceState) {
 
     @Override
     public boolean onCreateOptionsMenu(Menu menu) {
-        // Inflate the menu; this adds items to the action bar if it is present.
+        // Inflate the menu; this adds items to the app bar if it is present.
         getMenuInflater().inflate(R.menu.ui_components_menu, menu);
 
         SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);

AAD-Preparation/app/src/main/java/com/catherine/materialdesignapp/utils/NotificationUtils.java

@@ -22,7 +22,7 @@ public class NotificationUtils extends ContextWrapper {
     public NotificationUtils(Context context) {
         super(context);
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O)
-            throw new IllegalArgumentException("Please call  NotificationUtils(Context, ChannelInfo)");
+            throw new IllegalArgumentException("Call NotificationUtils(Context, ChannelInfo)");
     }
 
 

KotlinFromScratch/src/Lambdas.kt

@@ -20,7 +20,7 @@ class Lambdas {
 
         println("")
         println("Replace callbacks - Kotlin style")
-        // By using higher-order functions, the above code could be optimised
+        // By using higher-order functions, the preceding code could be optimised
         val kotlinButton = KotlinButton()
         kotlinButton.setOnClickListener {
             println("onClick")