Merge pull request #939 from marionbarker/release/3.8.0

Update LoopDocs for release v3.8.0

Author: marionbarker

docs/build/computer.md

@@ -38,26 +38,9 @@ If you have access to a computer with MacOS 14.0 or newer, you can skip ahead to
 
 ## Compatible Versions
 
-The current release of&nbsp;_<span translate="no">Loop</span>_&nbsp; requires Xcode version 15 or higher regardless of the iOS on the phone. This requires macOS 13.5 or higher.
+We used to keep track of the minimum Xcode and macOS that enabled users to keep building with their (often older) Mac computer.
 
-* If your phone is iOS 17.4 or newer, you must have macOS 14.0 or higher.
-* If your phone is iOS 18.0 or newer, you must have macOS 14.5 or higher.
-* As an alternative, use [Build with Browser](../browser/bb-overview.md){: target="_blank" }, which supports iOS 15, 16, 17 and 18.
-
-When this page was last updated, macOS 14.6 and Xcode 15.4 were tested to successfully build the app for phones with iOS 15 through iOS 18.0.1. Newer versions, macOS 15 and Xcode 16 work as well.
-
-> Release 3.4.2 and newer fix an issue building *Loop* with Xcode 16. If your current *Loop* app does not show your expiration date, please rebuild to version 3.4.4 as soon as possible.
-
-The table below lists the **minimum** requirements to build the current release of&nbsp;<span translate="no">Loop 3.4.4</span>. If your macOS or Xcode version is higher, you can build with *Mac*.
-
-Find your phone iOS in the table below. If your iOS is not listed, e.g., 17.6.1, choose the first row that is less than your iOS.
-
-| iOS Version | minimum Xcode | minimum macOS | 
-|:---:|:---:|:---:|
-| 18.0 | 15.4 | 14.5 |
-| 17.5 | 15.4 | 14.0 |
-| 17.4 | 15.3 | 14.0 |
-| 15.1 to<br>17.0 | 15.0 | 13.5 |
+With the advent of browser build, this is no longer worth maintaining. If you don't or can't keep your Mac up to date, please use [Build with Browser](../browser/bb-overview.md){: target="_blank" }.
 
 !!! warning "iOS Dictates Your Computer Needs"
 
@@ -71,53 +54,47 @@ Do not use any of the beta macOS versions. (If you don't know what that means, y
 
 To find your macOS version, click on the Apple icon in the computer's upper left corner and select `About this Mac`. The graphic below highlights the macOS version with a red rectangle. Your computer can be a MacBook, iMac, macMini, etc. It will work to build Loop if it has the minimum required macOS version and enough storage.
 
-With the Ventura macOS version, the `About this Mac` display changed. For Ventura, when you tap on the `More Info` icon, it opens the General -> About screen from the System Settings menu. This is very similar to the phone Settings -> General -> About screen.
+> ![image showing macOS and system details](img/macos-13_and_newer.svg){width="300"}
 
-Sonoma, macOS 14.0, was released September 2023.
+To update your operating system:
 
-![image showing macOS and system details](img/macos-12-13.svg){width="750"}
-
-If you do not have the required minimum macOS version
-
-* For macOS 12.6.1 or earlier, check the `Software Update` button on the screen shown above
-* For macOS 13.0 or later, click on the Apple and choose `System Settings`
+* Click on the Apple and choose `System Settings` or click on the `More Info` button on the screen shown above
     * Select `General` and `Software Update`, just like you would on the phone interface
 
-Apple says upgrading to macOS Sonoma requires 26 GB of available storage.
-
 ## Check the Space Available
 
-You need to have 50 GB free space in order to install Xcode as directed on the [Xcode Version](xcode-version.md) page. At the top of the menu on the graphic above, click on the Storage Tab highlighted with a red rectangle, or, if running Ventura, tap on More Info to open the About screen (under System Settings->General), which includes storage at the bottom of the display.
+You need to have 50 GB free space in order to install Xcode as directed on the [Xcode Version](xcode-version.md) page. Tap on More Info to open the About screen (under System Settings->General), which includes storage at the bottom of the display.
 
  To free up space, move things like photos to an external drive. The Xcode application cannot be run from an external drive.
 
 If you are evaluating a used computer, it's best to have at least 256 GB total disk space (more is better).
 
-## Which Macs Are Compatible with macOS Sequoia?
 
-Sequoia is not yet required for building the *Loop* app on a phone running iOS 18 or higher with the *Mac* method. The normal *Apple* schedule is that you will be required to have this installed by April of the year after the *iOS* version increments. The only difference between this list and the one for Sonoma is the MacBook Air must be newer for Sequoia.
+## Which Macs Are Compatible with macOS Tahoe?
 
-* MacBook Pro introduced in 2018 or later
+Tahoe (macOS 26) is not yet required for building the *Loop* app on a phone running iOS 26 with the *Mac* method. The normal *Apple* schedule is that you will be required to have this installed by April of the year after the *iOS* version increments.
+
+* MacBook Pro introduced in 2020 or later
 * MacBook Air introduced in 2020 or later
-* Mac mini introduced in 2018 or later
-* iMac introduced in late 2019 or later
+* Mac mini introduced in 2020 or later
+* iMac introduced in late 2020 or later
 * iMac Pro introduced in 2017 or later
 * Mac Studio introduced in 2022 or later
 * Mac Pro introduced in 2019 or later
-* get the full list from [Apple for Sequoia](https://support.apple.com/en-us/120282)
+* get the full list from [Apple](https://www.apple.com/os/macos/)
 
-## Which Macs Are Compatible with macOS Sonoma?
+## Which Macs Are Compatible with macOS Sequoia?
 
-Sonoma is required for building the *Loop* app on a phone running iOS 17.4 or higher with the *Mac* method. You can install Sonoma on the following:
+Sequoia (macOS 15) is required for building the *Loop* app on a phone running iOS 18.6 or higher with the *Mac* method. 
 
 * MacBook Pro introduced in 2018 or later
-* MacBook Air introduced in 2018 or later
+* MacBook Air introduced in 2020 or later
 * Mac mini introduced in 2018 or later
 * iMac introduced in late 2019 or later
 * iMac Pro introduced in 2017 or later
 * Mac Studio introduced in 2022 or later
 * Mac Pro introduced in 2019 or later
-* get the full list from [Apple for Sonoma](https://support.apple.com/en-us/105113)
+* get the full list from [Apple for Sequoia](https://support.apple.com/en-us/120282)
 
 ## Older Macs
 

docs/build/img/macos-12-13.svg

@@ -22,9 +22,9 @@
 
 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. The *Loop* app is compatible with iPhone devices with *iOS* 15.1 or newer. 
+You need a minimum version of the mobile operating software, called the *iOS*, to be installed on your iPhone. The *Loop* app is fully compatible with iPhone devices with *iOS* 16.1 or newer, and mostly compatible with *iOS* 15 devices.
 
-* It is unusual for four different *iOS* to be supported
+* It is unusual for five different *iOS* to be supported
 * The developers try to maintain support for the current and one-level earlier *iOS*
     * Be prepared for your *iOS* 15 device to no longer be supported in future releases
     * Be prepared for your *iOS* 16 device to no longer be supported in future releases
@@ -41,7 +41,11 @@ You need a minimum version of the mobile operating software, called the *iOS*, t
 
     > DASH pods that advertise with a Bluetooth Device name of `TWI Board` and are fully compatible with all phones listed below.
 
-All the devices listed below are currently compatible with Loop. They are separated by the available *iOS* for the phone. Those that only support *iOS* 15 or 16 may become incompatible for the next version of the *Loop* app, but can be used with `Loop version 3.6.x`.
+All the devices listed below are currently compatible with Loop. They are separated by the available *iOS* for the phone. Those that only support *iOS* 15 or 16 may become incompatible for the next version of the *Loop* app, but can be used with `Loop version 3.8.x`.
+
+These phones require *iOS* 26
+
+- iPhone 17, all variants
 
 These phones require *iOS* 18
 
@@ -65,6 +69,13 @@ These phones are limited to *iOS* 16.
 
 These phones are limited to *iOS* 15.
 
+**Warning**: several features of the *Loop* app do not work with *iOS* 15 devices for v3.8.0 and newer:
+
+* The Widget does not display properly
+* The Mixpanel Service is not available
+
+Other features of the *Loop* app do work, but please find a newer phone soon.
+
 - iPhone 7, all variants
 - iPhone 6s or 6s Plus, note the `s`
 - iPhone SE (1st generation; 2016 first release)

docs/build/img/macos-13_and_newer.svg

@@ -75,32 +75,22 @@ After any update of [macOS](computer.md#check-your-macos-version) or Xcode, it i
 
 ## How do all the minimum versions relate to each other?
 
-### Compatible Versions
-
-The current release of&nbsp;_<span translate="no">Loop</span>_&nbsp; requires Xcode version 15 or higher regardless of the iOS on the phone. This requires macOS 13.5 or higher.
-
-* If your phone is iOS 17.4 or newer, you must have macOS 14.0 or higher.
-* If your phone is iOS 18.0 or newer, you must have macOS 14.5 or higher.
-* As an alternative, use [Build with Browser](../browser/bb-overview.md){: target="_blank" }, which supports iOS 15, 16, 17 and 18.
+This section is no longer updated.
 
-When this page was last updated, macOS 14.6 and Xcode 15.4 were tested to successfully build the app for phones with iOS 15 through iOS 18.0.1. Newer versions, macOS 15 and Xcode 16 work as well.
+We used to keep track of the minimum Xcode and macOS that enabled users to keep building with their (often older) Mac computer.
 
-> Release 3.4.2 and newer fix an issue building *Loop* with Xcode 16. If your current *Loop* app does not show your expiration date, please rebuild to version 3.4.4 as soon as possible.
+With the advent of browser build, this is no longer worth maintaining. If you don't or can't keep your Mac up to date, please use [Build with Browser](../browser/bb-overview.md){: target="_blank" }.
 
-The table below lists the **minimum** requirements to build the current release of&nbsp;<span translate="no">Loop 3.4.4</span>. If your macOS or Xcode version is higher, you can build with *Mac*.
 
-Find your phone iOS in the table below. If your iOS is not listed, e.g., 17.6.1, choose the first row that is less than your iOS.
+### Compatible Versions
 
-| iOS Version | minimum Xcode | minimum macOS | 
-|:---:|:---:|:---:|
-| 18.0 | 15.4 | 14.5 |
-| 17.5 | 15.4 | 14.0 |
-| 17.4 | 15.3 | 14.0 |
-| 15.1 to<br>17.0 | 15.0 | 13.5 |
+* Before the release of iOS 26, the version of iOS was 18.6.2 and could be built with Xcode 16.4 and macOS 15.6.1
+* To build on an iOS 26 device, you must use Xcode 26 with macOS 15.6 or newer
+* As an alternative, use [Build with Browser](../browser/bb-overview.md){: target="_blank" }, which supports iOS 15, 16, 17 and 18.
 
 ### Wikipedia Chart for Apple Versions
 
-This graphic (copied from Wikipedia and last updated March 2023) is not updated with every iOS update - use it as a map to read the minimum requirements.  Every attempt will be made to update the words in the [Minimum Version List](#how-do-all-the-minimum-versions-relate-to-each-other) promptly - that's much easier than updating a graphic.
+This graphic (copied from Wikipedia and last updated March 2023) is provided as a map to read the minimum requirements.
 
 Follow this link to [Wikipedia](https://en.wikipedia.org/wiki/Xcode) and scroll down to the current version of this figure - the graphic shown below is a map of how to read the current version of this figure at Wikipedia.
 

docs/build/phone.md

@@ -12,13 +12,19 @@ Please read this entire page before using any version of *Loop* other than the r
 
 ## Updates in `dev`
 
-This section provides an overview of changes to `dev` compared to `Loop 3.6.x`. 
+This section provides an overview of changes to `dev` compared to `Loop 3.8.x`. 
 
 Please check the [development channel in zulipchat](https://loop.zulipchat.com/#narrow/channel/144182-development) for notifications when an update to the `dev` branch is expected so you will be prepared. Do this **before** you install a `dev` build from TestFlight.
 
-The following features are found only in `dev` at this time. The updates are provided in reverse chronological order.
+There are no differences between `dev` and `main` at this time. 
 
-### v3.7.7
+## Older updates
+
+### Updates from v3.6 to v3.8
+
+The updates developed in the `dev` branch before the release of v3.8.0, are provided in reverse chronological order.
+
+#### v3.7.7
 
 The changes are to maintenance scripts and to translations with no change to the function of the code:
 
@@ -34,7 +40,7 @@ The changes are to maintenance scripts and to translations with no change to the
     * conversion to use String Catalogs for localization in the submodules with associated tweaks to Xcode configuration
     * updates to the CircleCI configurations
 
-### v3.7.6
+#### v3.7.6
 
 * Updated some localization (strings translated to different languages)
     * Added scripts to make localization more streamlined
@@ -43,25 +49,21 @@ The changes are to maintenance scripts and to translations with no change to the
     * Discarded some unneeded files
     * Updated to Xcode 16.4 for browser build and CircleCI quality testing
 
-### v3.7.5
+#### v3.7.5
 
 * Added support for Dana-i and DanaRS-v3 pump models
 
-### v3.7.0 through v3.7.4
+#### v3.7.0 through v3.7.4
 
-* `dev` v3.7.4 is same as [`main` v3.6.4](releases.md#loop-v364).
-* `dev` v3.7.3 is same as [`main` v3.6.3](releases.md#loop-v363).
-* `dev` v3.7.2 is same as [`main` v3.6.2](releases.md#loop-v362).
-* `dev` v3.7.1 is same as [`main` v3.6.1](releases.md#loop-v361).
-* `dev` v3.7.0 is same as [`main` v3.6.0](releases.md#loop-v360).
+* `dev` v3.7.x was same as [`main` v3.6.x](releases.md#loop-v364).
 
-## Updates from 3.4 to 3.6
+### Updates from v3.4 to v3.6
 
 All updates are reported in [`Loop 3.6.0`](releases.md#loop-v360){: target="_blank" }
 
 Check [Version History](releases.md#loop-3-version-history) for minor updates found in 3.6.x.
 
-## Updates from 3.2 to 3.4
+### Updates from v3.2 to v3.4
 
 Features new with v3.4, originally in the Updates in `dev` section before the release, have been inserted into the appropriate part of the *LoopDocs* website (indicated by the up-right arrow after the link). The links below are left to assist people in finding the features.
 

docs/build/xcode-version.md

@@ -8,9 +8,9 @@ For information about version 2 releases and compatibility between version 2 and
 
 ## Current Release
 
-The current released version for the *Loop* app is v3.6.4 and is built from the `main` branch of LoopWorkspace. The dates and contents for releases are summarized below in reverse chronological order (so newest release information comes first).
+The current released version for the *Loop* app is v3.8.0 and is built from the `main` branch of LoopWorkspace. The dates and contents for releases are summarized below in reverse chronological order (so newest release information comes first).
 
-> The current development version for the *Loop* app is v3.7.6 and is built from the `dev` branch of LoopWorkspace. See [Updates in `dev`](development.md#updates-in-dev){: target="_blank" } for a summary of difference between `main` and `dev`.
+> The current development version for the *Loop* app is v3.9.0 and is built from the `dev` branch of LoopWorkspace. See [Updates in `dev`](development.md#updates-in-dev){: target="_blank" } for a summary of difference, if any, between `main` and `dev`.
 
 ### What Version Do I Have?
 
@@ -29,6 +29,33 @@ Releases from `Loop v3.4.4` and older are reported at [*GitHub*&nbsp;_<span tran
 
 ## Loop 3 Version History
 
+- - -
+
+## Loop v3.8.x
+
+### Loop v3.8.0
+
+[*Loop* v3.8.0](https://github.com/LoopKit/LoopWorkspace/releases/tag/v3.8.0) was released on 14 September 2025.
+
+> When v3.8.0 was released, the `dev` branch version was similarly updated to v3.9.0
+
+#### v3.8.0 Highlights
+
+* Add support for Dana-i and DanaRS-v3 pump models
+* Update translations and convert to String Catalogs
+* Update to support iOS 26
+
+#### Limitations for *iOS* 15
+
+Note that iOS 15 devices do not support:
+
+* *Loop Widgets*, however, *Loop Widgets* continue to work with iOS 16 devices and iOS 18 and newer devices now support tinted widgets.
+* The Mixpanel Service is not available
+
+- - -
+
+## Loop v3.6.x
+
 ### Loop v3.6.4
 
 [*Loop* v3.6.4](https://github.com/LoopKit/LoopWorkspace/releases/tag/v3.6.4) was released on 31 July 2025.
@@ -166,6 +193,9 @@ Updates were made to the Omnipod pump submodules: OmniBLE and OmniKit. Unless ot
 * Logic fix for 049 pod fault with concurrent temp basal commands; fixed Trio Issue (PR 140, 48)
 * Logic fix for pump manager returns bogus podSuspended; fixed Trio Issue (PR 141, 49)
 
+- - -
+
+## Loop v3.4.x
 
 ### Loop v3.4.4
 
@@ -277,6 +307,9 @@ These features are added:
     * Glucose limits can now use the min or max value with no restrictions
 * Nightscout as a CGM works again for older iOS versions, it no longer requires iOS 17
 
+- - -
+
+## Loop v3.2.x
 
 ### Loop v3.2.3
 
@@ -332,7 +365,9 @@ Updates and new Features:
 * Add missing X-Large watch complications. [link](https://github.com/LoopKit/Loop/pull/1901)
 * “Deactivate Pod” button on some screens changed to not be so alarming, as it doesn’t actually deactivate the pod, but takes you to a screen where you can, and has an option to cancel: [link](https://github.com/LoopKit/OmniBLE/pull/76)
 
-### Loop v3.0.0
+- - -
+
+## Loop v3.0.0
 
 After several years of development and a lot of testing, Loop 3 is here!
 
@@ -426,7 +461,9 @@ For example:
     * `Loop v3.5.0` was the development version before `Loop v3.6.0` was released
 * `Loop v3.6.0` was the next minor release
     * `Loop v3.6.1`, `Loop v3.6.2`, `Loop v3.6.3` and `Loop v3.6.4` were updates without major changes to the features of `Loop v3.6`
-    * `Loop v3.7.7` is the current development version, see [Updates in dev](development.md#updates-in-dev) for functional differences between `main` and `dev`
+    * `Loop v3.7.7` was the development version before `Loop v3.8.0` was released
+* `Loop v3.8.0` was the next minor release
+    * `Loop v3.9.0` is the current development version, see [Updates in dev](development.md#updates-in-dev) for functional differences, if any, between `main` and `dev`
 
 - - -