From 3f805bdb1ea046b6f123e5b3956220f9afa27e00 Mon Sep 17 00:00:00 2001
From: Thomas Weber <muffin@muffin.ink>
Date: Tue, 4 Jan 2022 22:28:17 -0600
Subject: [PATCH] Continue improving phrasing

---
 src/p4/PackagerOptions.svelte | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/src/p4/PackagerOptions.svelte b/src/p4/PackagerOptions.svelte
index 5f10f335..107159cd 100644
--- a/src/p4/PackagerOptions.svelte
+++ b/src/p4/PackagerOptions.svelte
@@ -779,20 +779,21 @@
               Unlike the other environments, Android support is not fully automated. You must manually create an app. This section will try to guide you through the process.
             </div>
 
-            <p>This section assumes you have complete access to a Windows, macOS, or Linux computer.</p>
+            <p>This section assumes you have full access (including adminstrator/root) to a Windows, macOS, or Linux computer.</p>
+            <p>Parts of this section may be generated by various options selected above.</p>
 
             <h3>Install Android Studio</h3>
             <p><a href="https://developer.android.com/studio/">Install Android Studio.</a></p>
             <p>This is quite large and may take a while.</p>
 
             <h3>Create a new project</h3>
-            <p>Create a new project in Android studio.</p>
+            <p>Create a new project in Android Studio.</p>
             <ul>
               <li>Use the "Empty Activity" template</li>
               <li>Set Name to your app's name, for example "<code>{$options.app.windowTitle}</code>"</li>
               <li>Set Package name to "<code>org.turbowarp.packager.userland.{$options.app.packageName}</code>"</li>
               <li>Choose a save location that you won't forget</li>
-              <li>Set Language to Kotlin</li>
+              <li>Set Language to "Kotlin"</li>
               <li>Set Minimum SDK to "API 21: Android 5.0 (Lollipop)"</li>
             </ul>
 
@@ -836,7 +837,8 @@
                 '}'
               ].join('\n')}
             </pre>
-            <p>At this point, you now have a fully functional Android app. However, there are still a few more things you should change.</p>
+            <p>Make sure to leave the first line that says <code>package ...</code></p>
+            <p>At this point, you have a functional Android app. However, there are still a few more things you should change.</p>
 
             <h3>Fixing screen orientation issues</h3>
             <p>In the sidebar on the left, open app > main > AndroidManifest.xml</p>
@@ -860,7 +862,7 @@
             </pre>
 
             <h3>Updating colors</h3>
-            <p>If you ran the app now, it would have a purple color scheme, which may not be what you want. This can be changed.</p>
+            <p>Currently the app has a purple color scheme, which may not be what you want. This can be changed.</p>
             <p>In the sidebar on the left, open app > main > res > values > color.xml.</p>
             <p>You will see these lines:</p>
             <pre>
@@ -870,7 +872,7 @@
                 '    <color name="purple_700">#FF3700B3</color>',
               ].join('\n')}
             </pre>
-            <p>Replace those lines with:</p>
+            <p>Replace those lines with: (the following snippet is generated according to your configured background color)</p>
             <pre>
               {[
                 `    <color name="purple_200">#FF${$options.appearance.background.substr(1)}</color>`,
@@ -879,11 +881,11 @@
               ].join('\n')}
             </pre>
             <p>Do not change the other lines.</p>
-            <p>The above snippet will make the status bar match your app's background color. For advanced users, note that these color codes are a bit unusual in that the "alpha" or "transparency" byte goes first instead of last.</p>
-            <p>Ignore the bits about <code>purple_yyy</code> -- just them as is. While it would be a good idea to these colors, you will be making more work for yourself because you'll have to update some other files to reflect the new names.</p>
+            <p>For advanced users, note that these color codes are a bit unusual in that the "alpha" or "transparency" byte (typically <code>255</code> or <code>FF</code>) goes first instead of last.</p>
+            <p>Ignore the bits about <code>purple_yyy</code>; just them as is. It would typically be a good idea to rename these colors, but you will be making more work for yourself because you'll have to update some other files to reflect the new names.</p>
 
             <h3>Updating the project</h3>
-            <p>It's likely that at some point you will want to update the project without redoing this entire guide. Updating is much simpler:</p>
+            <p>It's likely that at some point you will want to update the project without redoing this entire guide. Updating a project is much simpler:</p>
             <ol>
               <li>Open Android Studio and open the project</li>
               <li>Delete everything inside the assets folder</li>