minor clean-up

Author: marionbarker

docs/browser/prepare-fork.md

@@ -190,9 +190,7 @@ Once all six <code>Secrets</code> have been added to your <code>LoopWorkspace</c
 
 ### Add Variable
 
-This is a new step. It is already included in the `dev` branch and will be included in the `main` branch when `Loop 3.6.0` is released.
-
-It is optional but strongly recommended.
+This is a new step. It will be used when `Loop 3.6.0` is released. This enables automatic generation and renewal of the certificates needed to build your app.
 
 1. While in the same screen where you enter the `Secrets`, click on the `Variables` tab to the right of the `Secrets` tab:
 1. Select new variable and give it the name the `ENABLE_NUKE_CERTS` and enter `true` as the value
@@ -220,7 +218,7 @@ If you are someone who already has a lot of forks in your personal account and w
 
 1. Follow the steps to create your organization
     * [Create a Free *GitHub* Organization](secrets.md#create-a-free-github-organization){: target="_blank" }
-1. Add the `Secrets` and the new `Enviornment` variable as explained in [Prepare to Enter `Secrets`](#prepare-to-enter-secrets)
+1. Add the `Secrets` and the `Variable` as explained in [Prepare to Enter `Secrets`](#prepare-to-enter-secrets)
 1. Fork all the repos you normally use, but this time, set your organization as the owner
 1. For each repository in your organization:
     * Tap on the Actions tab
@@ -237,7 +235,7 @@ If you are someone who already has a lot of forks in your personal account and w
 
 **Important**
 
-> Your personal *GitHub* account is still needed. The free organization points to your private account as a member. Please do not try to delete your personal *GitHub* account.
+> Your personal *GitHub* account is still needed. The free organization points to your private account as a member. If you delete your personal *GitHub* account, you lose access to your organization account too.
 
 ## Already Have&nbsp;<span translate="no">LoopWorkspace</span>?
 

docs/browser/secrets.md

@@ -16,7 +16,7 @@
 
 You need to save your information digitally, so you can copy and paste. The information is created in one place and used in another. Refer to [Configure <code>Secrets</code>](prepare-fork.md#configure-secrets){: target="_blank" } for how the <code>Secrets</code> are used. In addition to the 6 <code>Secrets</code>, other important information to keep handy (like usernames and passwords) is listed below. Be sure to keep this file secure.
 
-**Created at developer.apple.com**
+**Created / used at developer.apple.com**
 
 * Email address (this is your username)
 * password
@@ -26,14 +26,15 @@ You need to save your information digitally, so you can copy and paste. The info
     * <code>FASTLANE_KEY_ID</code>
     * <code>FASTLANE_KEY</code>
 
-**Created at github.com**
+**Created / used at github.com**
 
 * Email address
 * password
 * username
-* Your *GitHub* address will be: `https://github.com/my-name`
-* Your (optional but recommended) *GitHub* organization address will be : `https://github.com/my-name-org`
-* Your LoopWorkspace repository address will be: `https://github.com/my-name-org/LoopWorkspace`
+* If your username is `my-name` then:
+    * Your *GitHub* address (URL) will be: `https://github.com/my-name`
+    * Your (optional but recommended) *GitHub* organization address will be : `https://github.com/my-name-org`
+    * Your LoopWorkspace repository address will be: `https://github.com/my-name-org/LoopWorkspace`
 * One item used as a Secret
     * *GitHub* Personal Access Token (<code>GH_PAT</code>)
 

docs/nightscout/remote-config.md

@@ -36,9 +36,9 @@ API_SECRET
 
 choose-something-hard-to-guess
 
-* must contain at least 12 characters
-* hint: don’t make it too long and do not put special characters in it (better stick to letters and numbers)
-* It is case-sensitive
+* must contain at least 12 characters and is case-sensitive
+* hint: don’t make it too long, best to use letters and numbers,
+  best to avoid special characters
 
 If you also use Browser Build method, you need to be careful not to mix 
 up your keys.

docs/version/development.md

@@ -12,16 +12,14 @@ Please read this entire page before using any version of *Loop* other than the r
 
 ## Updates in `dev`
 
-This section is an early look at major features added to dev since Loop 3.4 was released.
+This section is provides an overview of changes to dev compared to `Loop 3.4.4`.
 
 ### Add Automatic Certificate Generation and Renewal
 
-These changes in the build process only work when `dev` is your default branch.
+These changes in the build process only work when `dev` is your default branch. Once `Loop 3.6.0` is released, these changes will work with the `main` branch.
 
 Automatic certificate generation and renewal requires a `Variable` be added to your organization or your repository. Please see these instructions: [Add Variable](prepare-fork.md#add-variable){: target="_blank" }
 
-Note - there is no harm adding the variable even before the code is updated to use it.
-
 ### Loop Updates
 
 Updates made to Loop or LoopKit submodules affect the operation of Loop.