Merge pull request #926 from marionbarker/working-docs

Update for Loop 3.6.2

Author: marionbarker

docs/browser/bb-errors.md

@@ -1,20 +1,5 @@
 ## Help with Errors
 
-!!! important "Browser Build Temporarily Unavailable for New Builders"
-    *Apple* made a modification in May 2025 that impacted Browser Build for builders who needed to renew their certificates or generate Identifiers. 
-    
-    A partial update was instituted on 13 June 2025 for Loop (with other apps like LoopCaregiver, LoopFollow and Trio updated about that time). This restored the ability for current builders to build again.
-
-    * If you previously built and had a valid certificate, you probably did not notice the issue
-    * If you previously built, but needed to renew your certificate, you were not able to build for a few weeks but that is now resolved
-    * If this is your first time building a particular app, then the ability to create **Identifiers** for that app is still impacted
-        * A solution is being tested but is not currently available in the released code
-
-    > Building with a Mac in not affected.
-
-    > If your Identifiers are configured, Browser Build works normally now.
-
-
 !!! important "Get Help, Not Frustrated"
     For first-time builders, there are a lot of one-time steps that all have to be correct and many screens look similar.
 
@@ -106,9 +91,6 @@ If you get an error in an Action. Click on the link and scroll down to view the
 
 ## New Builder: Quick Reference
 
-!!! important "Browser Build Temporarily Unavailable for New Builders"
-    New builders can build at this time but only if they manually create Identifiers and configure each Identifier with the required capabilities. It is recommended that new builders wait for the next fix to be released.
-
 ### New Builder: Validate <code>Secrets</code> Error
 
 This is the first step. If you have not succeeded (&#x2705;) with this action - STOP.
@@ -124,9 +106,6 @@ If you want to try to solve it yourself, refer back to these section in the docu
 
 ### New Builder: Add Identifiers Error
 
-!!! important "Browser Build Temporarily Unavailable for New Builders"
-    New builders can build at this time but only if they manually create Identifiers and configure each Identifier with the required capabilities. It is recommended that new builders wait for the next fix to be released.
-
 If you succeeded with Validate <code>Secrets</code>, this should also succeed. If it does not, please skip ahead to [Action: `Add Identifiers` Error`](#action-add-identifiers-errors).
 
 Do not hesitate to [ask a mentor for help](#where-to-get-help-with-browser-build).
@@ -208,7 +187,9 @@ If necessary, enable the build action at your repository as shown in the graphic
 
 ### Rebuild: Create Certificates Error
 
-With `Loop 3.6.0`, these should be a thing of the past - but you must first manually update (sync) your repository in order to get this feature added and you must do this new step [Add Variable](prepare-fork.md#add-variable){: target="_blank" }
+With `Loop 3.6.1` or newer, these should be a thing of the past - but you must first manually update (sync) your repository in order to get this feature added and you must do this new step [Add Variable](prepare-fork.md#add-variable){: target="_blank" }.
+
+> Note - we used to say with `Loop 3.6.0`, this was no longer an issue. However, Apple changed part of their infrastructure in May 2025 and it took us a while to get this fixed.
 
 > Caveat - your Apple Developer account must be in good standing with a valid credit card attached and all agreements signed.
 
@@ -229,7 +210,7 @@ If you get an error when building with a browser, you can use this page to figur
 
     If you have more than one Distribution Certificate, you may need to delete the oldest one using these instructions: [Revoke Extra Distribution Certificate](bb-errors.md#revoke-extra-distribution-certificate){: target="_blank" }.
 
-    * With `Loop 3.6.0` and newer, this should not happen. Make sure you [Add Variable](prepare-fork.md#add-variable){: target="_blank" } to automatically renew certificates.
+    * With `Loop 3.6.1` and newer, this should not happen. Make sure you [Add Variable](prepare-fork.md#add-variable){: target="_blank" } to automatically renew certificates. It only happened with `Loop 3.6.0` when Apple made a change to their infrastructure.
 
 These are some of the most common errors to date.
 
@@ -786,14 +767,11 @@ Assuming you have successfully built using the Browser-Build / *GitHub* method b
 
 ## Handle the `FastLane API Key` Error
 
-!!! important "Browser Build Temporary Issue"
-    *Apple* made a modification in May 2025 that impacted Browser Build for builders who needed to renew their certificates or generate Identifiers. 
-    
-    A partial update was instituted on 13 June 2025 for Loop (with other apps like LoopCaregiver, LoopFollow and Trio updated about that time). This restored the ability for current builders to build again.
-
-    * If you previously built and had a valid certificate, you probably did not notice the issue
-    * If you previously built, but needed to renew your certificate, you were not able to build for a few weeks but that is now resolved
+This was never an actual error - but a procedure that worked briefly. There is no need to revoke and generate a new `FastLane API Key`.
 
+!!! important "Browser Build Temporary Issue is Fixed with `Loop 3.6.2`"
+    *Apple* made a modification in May 2025 that impacted Browser Build for builders who needed to renew their certificates or generate Identifiers. With the release of `Loop 3.6.2`, these issues are resolved.
+    
     It took several weeks for the change at *Apple* to propagate through all the `API Keys`. Thus an adhoc fix worked initially but then stopped working. An update to fastlane (the code the communicates between *Apple* and *GitHub*) is now in the released Loop code (3.6.1 and newer).
 
 We have removed the section on getting a new Fastlane API Key - that is not the solution to what turned out to be a change made by *Apple*.

docs/browser/bb-overview.md

@@ -1,19 +1,5 @@
 ## Build with a Browser
 
-!!! important "Browser Build Temporarily Unavailable for New Builders"
-    *Apple* made a modification in May 2025 that impacted Browser Build for builders who needed to renew their certificates or generate Identifiers. 
-    
-    A partial update was instituted on 13 June 2025 for Loop (with other apps like LoopCaregiver, LoopFollow and Trio updated about that time). This restored the ability for current builders to build again.
-
-    * If you previously built and had a valid certificate, you probably did not notice the issue
-    * If you previously built, but needed to renew your certificate, you were not able to build for a few weeks but that is now resolved
-    * If this is your first time building a particular app, then the ability to create **Identifiers** for that app is still impacted
-        * A solution is being tested but is not currently available in the released code
-
-    > Building with a Mac in not affected.
-
-    > If your Identifiers are configured, Browser Build works normally now.
-
 * <span translate="no">Loop 3</span>&nbsp;can be built with a web browser using <span translate="no">GitHub Actions</span>
 * The app is then installed by you on your phone using the *TestFlight* app
 * If you prefer to use *Xcode* on your *Mac*, head over to [Build with *Mac*](../build/overview.md){: target="_blank" }

docs/browser/identifiers.md

@@ -67,12 +67,6 @@ The `Validate Secrets` &nbsp;<span class=notranslate>Action</span>&nbsp; should
 
 ## <code>Add Identifiers</code>
 
-!!! important "Add Identifiers Temporarily Unavailable"
-    The Add Identifiers action does not work at this time.
-
-    A solution is being tested but is not currently available in the released code. For now, please be patient.
-
-
 ??? abstract "Section Summary (click to open/close)"
     1. Click on the "Actions" tab of your LoopWorkspace repository.
     1. On the left side, select "2. Add Identifiers".

docs/browser/img/add-time-sensitive-notifications-loop-identifier.png

@@ -1,9 +1,5 @@
 ## Summary of Steps
 
-!!! important "Browser Build Temporarily Unavailable for New Builders"
-    New builders should probably wait a few days for the next update before attempting to build a new app. You can manually configure Identifiers (very tedious), and then build, but waiting is probably the right choice. You can do all the steps leading up the to the <code>Add Identifiers</code> action.
-
-
 ???+ info "Time Estimate (click to open/close)"
     - If you have never built the *Loop* app (allow up to one week elapsed time)
         * Request and get an <span>*Apple Developer* Account</span>: 1-2 days

docs/browser/intro-summary.md

@@ -150,11 +150,10 @@ The `Validate Secrets` &nbsp;<span class=notranslate>Action</span>&nbsp; should
 
 ## Add Identifiers
 
-!!! important "Add Identifiers Temporarily Unavailable"
-    The Add Identifiers action does not work at this time.
+!!! important "Add Identifiers were Temporarily Unavailable"
+    The Add Identifiers action stopped working for a time. The timing for the release of the fix for LoopCaregiver may be delayed slightly. It is fixed for dev branch of LoopFollow and will be released to LoopFollow main soon.
 
-    A solution is being tested but is not currently available in the released code. 
-    For now, please be patient.
+    If you are a new builder and Add Identifiers does not work - please wait a day or two and try again.
 
 Near the top middle of your Repository fork, click on the "Actions" tab.
 
@@ -226,12 +225,6 @@ Click to open this link in a new tab: [`Certificates, Identifiers & Profiles: Id
 
 #### Table with Name and Identifier for `LoopCaregiver`
 
-!!! important "Add Identifiers Temporarily Unavailable"
-    The Add Identifiers action does not work at this time.
-
-    A solution is being tested but is not currently available in the released code. 
-    For now, please be patient.
-
 All five of these identifiers should be found after running the `Add Identifier` action on *GitHub*.
 
 If you do not see them, please sync your `LoopCaregiver` repository and then run the [`Add Identifier` action](identifiers.md#add-identifiers). The **`NAME`** might begin with an `XC` if you previously built with Xcode. However, the **`IDENTIFIER`** column value should match.

docs/browser/other-apps.md

@@ -167,7 +167,13 @@ Look in the **`IDENTIFIER`** column to locate each Identifer. The name in the **
 
 Click on each **`IDENTIFIER`** in turn and the `Edit Your App ID Configuration` screen will open.
 
-The example graphic below has numbered steps that match these directions:
+#### Add Time Sensitive Notifications
+
+There is one difference for the Loop Identifier from the other 3 Identifiers. You must manually enable the Time Sensitive Notifications capabilty. Follow the directions below for adding the Loop App Group, but keep scrolling down until you see the Time Sensitive Notifications. Make sure that check box is enabled, as shown in the graphic below. If you do not do this, the Build will fail.
+
+> ![graphic showing selection of the time sensitive notifications](img/add-time-sensitive-notifications-loop-identifier.png){width="300"}
+
+The example graphic below has numbered steps that match these directions. The columns from left to right are `Capabilities`, `App Services` and `Capability Requests`. With the exception of one App Service (for Loop), the check box under `Capabilities` will already be checked for you.:
 
 1. Looking at the `App Services` column, scroll down to the `App Groups` row and ensure the check box (under the `Capabilities column`) for `App Groups` is checked
 2. If the word `Configure` shows up, tap on it
@@ -190,6 +196,7 @@ The full list of Identifiers should be displayed again.
 Repeat until the 4 Identifiers have the `Loop App Group` configured.
 
 * If you miss an identifier, the `Create Certificates` step will succeed but `Build Loop` will fail.
+* If you do not [enable the `Time Sensitive Notifications`](#add-time-sensitive-notifications) for the `Loop` Identifier, the `Create Certificates` step will succeed but `Build Loop` will fail.
 
 ## Digital Service Act Compliance
 

docs/browser/prepare-app.md

@@ -6,7 +6,7 @@ For information about version 2 releases and compatibility between version 2 and
 
 ## Current Release
 
-The current released version for the *Loop* app is 3.6.1. 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 3.6.2. The dates and contents for releases are summarized below in reverse chronological order (so newest release information comes first).
 
 ### What Version Do I Have?
 
@@ -23,6 +23,24 @@ Releases from `Loop 3.4.4` and older are reported at [*GitHub*&nbsp;_<span trans
 
 ## Loop 3 Version History
 
+### Loop v3.6.2
+
+[*Loop* v3.6.2](https://github.com/LoopKit/LoopWorkspace/releases/tag/v3.6.2) was released on 25 June 2025.
+
+There are no changes to the *Loop* app - this is a Browser Build fix only.
+
+This release is the second fix for Browser Build features that stopped working when Apple made changes to their infrastructure beginning in May 2025. Those with valid Identifiers and build credentials probably did not notice that there was a problem.
+
+**Fixed**
+
+* The ability to run the `Add Identifiers` action is fixed with this version
+
+**Not Fixed**
+
+This only affects new builders and the instructions are updated to accomodate this restriction.
+
+* We can no longer automatically enable the capability for Time Sensitive Notifications for Loop. This capability must be added manually as directed in this section: [Add Time Sensitive Notifications](../browser/prepare-app.md#add-time-sensitive-notifications){: target="_blank" }
+
 ### Loop v3.6.1
 
 [*Loop* v3.6.1](https://github.com/LoopKit/LoopWorkspace/releases/tag/v3.6.1) was released on 13 June 2025.