Merge pull request #974 from marionbarker/release_3.10.0

LoopDocs for Release 3.10.0

Author: marionbarker

docs/browser/automatic.md

@@ -4,21 +4,23 @@ The instructions provided for building with a browser include settings to automa
 
 ## Manual Action for Automatic Build
 
-!!! important "Automatic Build Requires Manual Action"
+!!! warning "Browser Build for *Loop* Disabled?"
+    We do not know why, but GitHub is disabling the Build Loop Action for LoopWorkspace even though the repository is not stale.
+
+    If this is happening to you, see [What Manual Action is Required?](#what-manual-action-is-required).
+
+    * The automatic build actions should occur every Sunday
+        * The automatic build using the same code works for all OS-AID apps except for *Loop*
+        * See this [GitHub Discussion topic for details](https://github.com/orgs/community/discussions/181236)
+
+??? tip "Stale Repositoriy Always Requires Manual Action (Click to Open Close)"
     *GitHub* automatically **disables actions** that run according to a schedule if the repository in question is **inactive**.
 
     What does that mean?
 
     * **inactive** means stable code (no new commit within the last 60 days)
     * **disables actions** means the Build Action shows up as disabled
 
-!!! warning "Browser Build Disabled"
-    We do not know why, but GitHub is disabling the Build Loop Action for LoopWorkspace even though the repository is not stale.
-
-    * The automatic build actions should occur every Sunday
-        * The automatic build using the same code works for all OS-AID apps except for *Loop*
-        * See this [GitHub Discussion topic for details](https://github.com/orgs/community/discussions/181236)
-
 ### What Manual Action is Required?
 
 For any repository that shows the build action disabled, you should enable the action and do a manual build.
@@ -27,6 +29,7 @@ For any repository that shows the build action disabled, you should enable the a
     * Check that *TestFlight* has a new build of the *Loop* (or other) app
     * If not, go to your repository to see if the build action is disabled
 * If necessary, enable the build action at your repository as shown in the graphic below and then launch a manual build
+* If you are building any branch other than the default branch for your `fork`, don't forget to select that branch as part of Step 5 in the graphic below
 
 ![fix a disabled build state](img/build-disabled-fix.png )
 

docs/browser/bb-errors.md

@@ -11,16 +11,16 @@
 
 **Choose Browser Build if:**
 
-* ✓ You don't have a Mac or prefer not to use one
-* ✓ You want automatic monthly builds (after initial setup)
-* ✓ You're comfortable following step-by-step instructions with multiple accounts (Apple, GitHub)
-* ✓ You can dedicate 2-4 hours for first-time setup (spread over several days)
+- [x] You don't have a Mac or prefer not to use one
+- [x] You want automatic monthly builds (after initial setup)
+- [x] You're comfortable following step-by-step instructions with multiple accounts (Apple, GitHub)
+- [x] You can dedicate 2-4 hours for first-time setup (spread over several days)
 
 **Choose Mac Build if:**
 
-* You already have an up-to-date Mac and are comfortable with Xcode
-* You prefer building locally without cloud services
-* See [Build with Mac](../build/overview.md){: target="_blank" } for Mac requirements
+- [x] You already have an up-to-date Mac and are comfortable with Xcode
+- [x] You prefer building locally without cloud services
+- [x] See [Build with Mac](../build/overview.md){: target="_blank" } for Mac requirements
 
 ## Requirements
 
@@ -143,13 +143,19 @@ For advanced users who want cutting-edge features before official release:
 
 | Feature | Browser Build | Mac Build |
 |---------|--------------|-----------|
-| **Computer Required** | Any device with browser | Mac with recent macOS |
+| **Device Required** | Any device with browser | Mac with recent macOS |
 | **Xcode Required** | No (GitHub provides) | Yes (must update regularly) |
 | **Initial Setup Time** | 2-4 hours over several days | 1-2 hours (if Mac is ready) |
-| **Monthly Updates** | Automatic | Manual via Xcode |
-| **Build Time** | ~1 hour (in cloud) | ~30 minutes (local) |
+| **Monthly Updates** | Automatic or<br>Five minutes with [Manual Actions](automatic.md#manual-action-for-automatic-build){: target="_blank"}<br>Build uploaded to TestFlight| Manual via Xcode |
+| **Build Time** | ~30 minutes (in cloud) | ~30 minutes (local) |
 | **App Expiration** | 90 days (TestFlight) | 1 year |
 | **Customization** | Supported | Supported |
 
+**Build Frequently** Please check monthly to see if there is a newer version of the *Loop* app.
+
+* Sometimes there is a new feature
+* Sometimes there is a required update to support the latest phone iOS
+* Even though a *Mac* lets you go a year between builds, you should build at least once a quarter
+
 Both methods produce the identical Loop app. Choose based on your available hardware and preferences.
 

docs/browser/bb-overview.md

@@ -48,8 +48,8 @@
         * [Create your version of *Loop* in `App Store` (personal use only, not for distribution)](prepare-app.md#create-loop-app-in-app-store-connect){: target="_blank" }
         * [Set up `Internal TestFlight Group for the App`](tf-users.md#testflight-overview){: target="_blank" }
     * *GitHub*:
-        * Action: 3. Create Certificates is included in Build Action with `Loop 3.6.0`
         * [`Action: 4. Build Loop`](build-yml.md#build-the-loop-app){: target="_blank" }
+            * Yes we can count, but Action 3 is included in Action 4
     * Phone: [Install the *Loop* app using the *TestFlight* app](phone-install.md){: target="_blank" }
 
 ???+ question "FAQs (click to open/close)"

docs/browser/img/example-identifier-build-errors.png

@@ -22,14 +22,13 @@
 
 The *Loop* app requires an *Apple* device and uses the *Apple Health* app to store and retrieve your blood glucose and insulin data and to store your carbohydrate records. Older iPads do not support *Apple Health* which used to be required, and is still strongly recommended, for the *Loop* app. It may be possible to run Loop with newer iPads and newer *iOS*, but this has not been tested.
 
-You need a minimum version of the mobile operating software, called the *iOS*, to be installed on your iPhone.
+You need a minimum version of the mobile operating software, called the *iOS*, to be installed on your iPhone. It is **strongly advised your phone hardware support and be updated to the most recent iOS**. This is for security and feature compatibility for *Loop* and companion apps.
 
-* As of v3.8.x, you must use iPhone devices with *iOS* 16.1 or newer
-* The next release will require *iOS* 17 or newer
-    * All phones that support *iOS* 17, also support 18 and 26
+!!! Danger "Update Older Phones!"
+    Some CGM vendors are limiting which iOS versions, and therefore which phones, are supported by their apps.
+
+    The Compatible Device list in LoopDocs is updated to reflect that. Devices that cannot be updated to the latest iOS version are treated as incompatible.
 
-* The developers maintain support for the current and one-level earlier *iOS*
- 
 ### Compatible Device
 
 All the devices listed below are currently compatible with Loop. They are separated by the available *iOS* for the phone. 
@@ -59,31 +58,18 @@ These phones are compatible with *iOS* 17, 18 and 26
 - iPhone SE (3rd generation or later model; 2022 first release)
 - iPhone SE (2nd generation; 2020 first release)
 
-### Older Devices
-
-If you are currently using an *iOS* 16 device, plan to replace it soon. The next version of the *Loop* app will require *iOS* 17 or newer.
-
-These phones are limited to *iOS* 16.
-
-- iPhone X, without an extra letter
-- iPhone 8, all variants
-
 ### Not Supported
 
-These phones are limited to *iOS* 15 and are no longer supported by the developers.
+**The [Older Devices](#older-devices) listed below are no longer supported by some CGM vendors and should be considered incompatible**
 
-**Warning**: several features of the *Loop* app do not work with *iOS* 15 devices:
+* **Please update your phone hardware and iOS as soon as possible**
 
-* The Widget does not display properly
-* The Mixpanel Service is not available
-* Some screens show up in different languages than the one selected for v3.8.0 and newer
+### Older Devices
 
-Other features of the *Loop* app do work, but please find a newer phone soon.
+These phones are limited to *iOS* 16. No longer supported by *Dexcom*. Update ASAP.
 
-- iPhone 7, all variants
-- iPhone 6s or 6s Plus, note the `s`
-- iPhone SE (1st generation; 2016 first release)
-- iPod Touch, 7th generation
+- iPhone X, without an extra letter
+- iPhone 8, all variants
 
 ## Find Your *iOS*
 
@@ -132,8 +118,14 @@ Please read: [The *Loop* Phone Must be on Automatic Time](../faqs/time-faqs.md#t
 
 **Please be proactive - install updates as soon as the all-clear is given for using the *Loop* app with that *iOS* update.**
 
-If a limitation on your *Mac* prevents you from updating your phone to the latest *iOS*, consider using [Build with Browser](../browser/bb-overview.md).
+If a limitation on your *Mac* prevents you from updating your phone to the latest *iOS*, switch to using [Build with Browser](../browser/bb-overview.md).
+
+!!! Important "Update While Awake and Aware"
+    The suggestion is to turn off automatic install of updates so you can be awake and aware when you do an iOS update. Otherwise, it happens in the middle of the night.
+
+    For major updates, for example iOS 18 to iOS 26, we suggest you hold off until the initial bugs get worked out. In other words when iOS 26.1 was released, the OK was given for everyone to update to iOS 26. Often, that includes an update to the Loop app to accommodate changes in the phone operating system.
 
+    For minor updates, for example iOS 26.1 to iOS 26.2, update at your earliest convenience.
 
 ### Why Turn off Automatic Updates?