update some headers and reorganize testflight explanation

Author: marionbarker

docs/browser/build-yml.md

@@ -14,7 +14,7 @@
         * Add them in [Users and Access](https://appstoreconnect.apple.com/access/users){: target="_blank" } on App Store Connect.
         * Add them to your *TestFlight* Internal Testing group.
 
-    [<span class="loop-bigger">:material-skip-forward:</span>](tf-users.md#set-up-users-and-access-testflight) To skip the detailed instructions, click on [Set Up Users and Access (TestFlight)](tf-users.md#set-up-users-and-access-testflight).
+    [<span class="loop-bigger">:material-skip-forward:</span>](tf-users.md#testflight-users-overview) To skip the detailed instructions, click on [*TestFlight* Users Overview](tf-users.md#testflight-users-overview).
 
 Refer to the graphic below for the first four steps:
 

docs/browser/intro-summary.md

@@ -41,7 +41,7 @@
     * *GitHub*:
         * [`Action: 3. Create Certificates`](certs.md#create-certificates){: target="_blank" }
         * [`Action: 4. Build Loop`](build-yml.md#build-the-loop-app){: target="_blank" }
-    * _<span translate="no">Apple</span>_: [Set up `Internal TestFlight Group`](tf-users.md#set-up-users-and-access-testflight){: target="_blank" }
+    * _<span translate="no">Apple</span>_: [Set up `Internal TestFlight Group`](tf-users.md#testflight-users-overview){: target="_blank" }
     * Phone: [Install the *Loop* app using the *TestFlight* app](phone-install.md){: target="_blank" }
 
 ???+ question "FAQs (click to open/close)"

docs/browser/other-apps.md

@@ -397,7 +397,7 @@ Please do not remove an existing app if you have trouble building a new one. You
 
 ## Add Users to *TestFlight* for App
 
-Once the first build completes, you will be able to configure *TestFlight* for the app - follow the template for setting up *TestFlight* for Loop found in [Configure to Use Browser: Set Up Users and Access (TestFlight)](../browser/tf-users.md#set-up-users-and-access-testflight).
+Once the first build completes, you will be able to configure *TestFlight* for the app - follow the template for setting up *TestFlight* for Loop found in [Configure to Use Browser: *TestFlight* Users Overview](../browser/tf-users.md#testflight-users-overview).
 
 ## Install on Phone
 

docs/browser/phone-install.md

@@ -4,7 +4,7 @@
 
 After you [Build the *Loop* App](../browser/build-yml.md#build-the-loop-app) with a browser and you get the email that it is availble in *TestFlight*, you are ready to install on as many phones as you and your family members need.
 
-* If you later need to add an adult family member to your list, refer to [Set Up Users and Access (TestFlight)](../browser/tf-users.md#set-up-users-and-access-testflight).
+* If you later need to add an adult family member to your list, refer to [*TestFlight* Users Overview](../browser/tf-users.md#testflight-users-overview).
 
 * Children (under 13 in US, varies by country) cannot use *TestFlight* with their ID. When you use [*TestFlight* for a Child](#testflight-for-a-child), you will need to use your ID on their phone (not the whole phone - just the Media & Purchase portion), so send the *TestFlight* invitation to the email associated with your ID.
 
@@ -47,7 +47,7 @@ If you already have the&nbsp;_<span translate="no">Loop</span>_&nbsp;app on the
 * Open the *TestFlight* app and find the name you used for your *Loop* app in the [Create *Loop* App in App Store Connect](../browser/prepare-app.md#create-loop-app-in-app-store-connect) step
 * If you have previously used *TestFlight* on this phone and don't see the latest build, sometimes quitting and restarting *TestFlight* will bring that new build into the list of available apps
 * Most people will just tap install to get the most recent build
-    * If you have more than one version number available in *TestFlight* you can can choose which version to install by tapping on the `Previous Builds` row and then selecting the desired version
+    * If you have more than one version number available in *TestFlight* you can choose which version to install by tapping on the `Previous Builds` row and then selecting the desired version
 * Tap on Install
     * If you already have the *Loop* app installed on this phone, you will be warned that the app already exists on your phone and that you might lose data
     * Click Install again (your pump connection and all your data will be fine)
@@ -59,9 +59,9 @@ If you already have the&nbsp;_<span translate="no">Loop</span>_&nbsp;app on the
 
 ## Automatic Update, Build, Install
 
-The instructions on the [Configure to Use Browser](intro-summary.md) pages will automatically take the following actions for released versions 3.4.0 and later:
+The instructions on the [Configure to Use Browser](intro-summary.md){: target="_blank" } pages will automatically take the following actions for released versions 3.4.0 and later:
 
-* Update the version of your&nbsp;<span translate="no">fork</span>&nbsp;within a week of the release
+* Update the version of your&nbsp;<span translate="no">fork</span>&nbsp;within a week of a new release release
     * Automatically create a new build and upload it to *TestFlight*
     * This is only for the `default` branch, typically `main`
 * Build the app at least once a month and upload it to *TestFlight*

docs/browser/tf-users.md

@@ -1,15 +1,20 @@
-## Set Up Users and Access (TestFlight)
+## *TestFlight* Users Overview
 
-> You repeat this step if you need to add a User to your account. For example, you want to add another adult who can install the app on your child's phone or you want a spouse or friend to have a copy of the app on their phone as backup for a trip.
+There are two parts to this.
 
-> As a developer, you are already included as a user with the Role of Account Holder, Admin. But you will need to add yourself to the TestFlight internal test group for each app you build.
+* A user must be registered under your [Your App Store Connect User List](#your-app-store-connect-user-list) before they can be added to a *TestFlight* internal test group for any app
+    * As a developer, you are already included as a user with the Role of Account Holder, Admin
+* Once the first build for a given app completes, you will be able to configure the [*TestFlight* Internal Testing Group](#configure-testflight-group-for-the-app) for that app
+    * You must add yourself to the *TestFlight* Internal Testing Group for each app
 
-Once the first build for a given app completes, you will be able to [Configure *TestFlight* Internal Testing Group](#configure-testflight-group-for-the-app) for that app.
+## Your App Store Connect User List
 
-!!! tip "Add Each User One Time"
-    Once you add a user to have access to your TestFlight internal test group for an app, you don't need to do it again - it remains available to them across rebuilds and different versions for that app.
+!!! tip "Step 1: add user for access for any of your apps"
+    Before you can select someone for the *TestFlight* Internal Testing group for any app, you must first add them to your App Store Connect User list.
+
+    As a developer, you are already included as a user with the Role of Account Holder, Admin.
 
-You are configuring a private capability for your family using an Internal Testing group. You need the *Apple ID* email address for each adult installing from your build. When building for a child, you will use your own *Apple ID*, not theirs. See [*TestFlight* for a Child](phone-install.md#testflight-for-a-child).
+You are configuring a private capability for your family using an Internal Testing group. You need the *Apple ID* email address for each adult installing from your build. When building for a child, you will use an adult's *Apple ID*, not theirs. See [*TestFlight* for a Child](phone-install.md#testflight-for-a-child).
 
 First you need to add the email address(es) to your *App Store Connect* Access Users list:
 
@@ -20,7 +25,10 @@ First you need to add the email address(es) to your *App Store Connect* Access U
 ![add email and role for your users](img/add-users.png){width="700"}
 {align="center"}
 
-### Configure *TestFlight* Group for the App
+## Configure *TestFlight* Group for the App
+
+!!! tip "Add user for each app"
+    Once you add a user to have access to your TestFlight internal test group for an app, you don't need to do it again - it remains available to them across rebuilds and different versions for that app.
 
 1. Open this link: [App Store Connect / Apps](https://appstoreconnect.apple.com/apps){: target="_blank" } to view your apps; log in if needed.