Merge pull request #922 from marionbarker/working-docs

Update Browser Build status for 3.6.1, fastlane 2.228.0

Author: marionbarker

docs/browser/bb-errors.md

@@ -1,11 +1,18 @@
 ## Help with Errors
 
-!!! important "Browser Build Temporarily Unavailable for New Builders and Some Updating Builders"
-    Over the last few weeks, the ability to add identifiers has been degrading and we provided what we thought was a solution - it was not.
+!!! 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
 
-    If your build is failing, reach out to see if the failure reason is something we can fix, but otherwise, please wait.
+    > Building with a Mac in not affected.
 
-    We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
+    > If your Identifiers are configured, Browser Build works normally now.
 
 
 !!! important "Get Help, Not Frustrated"
@@ -85,7 +92,9 @@ If there is no upright arrow by a link, then the location is on the same page:
 
 ### Look at the Annotation
 
-If you get an error in an Action. Click on the link and scroll down to view the annotation. An example is shown below. Most errors have a clear annotation telling you what to do. If the annotation is not clear to your, please [ask a mentor for help](#where-to-get-help-with-browser-build).
+If you get an error in an Action. Click on the link and scroll down to view the annotation. An example is shown below. Some errors have a clear annotation telling you what to do. If the annotation is not clear to your, please [ask a mentor for help](#where-to-get-help-with-browser-build).
+
+> Changes at *Apple* led to a number of new errors - these do have have nice annotations.
 
 ![graphic with an example validate secret error](img/example-annotation.png){width="800"}
 {align="center"}
@@ -98,10 +107,7 @@ 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 cannot build at this time because we cannot add Identifiers.
-
-    We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
-
+    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
 
@@ -119,10 +125,7 @@ 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 cannot build at this time because we cannot add Identifiers.
-
-    We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
-
+    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).
 
@@ -172,12 +175,8 @@ Ignore the warnings - this does not affect the build.
 
 ## Rebuild Errors: Quick Reference
 
-!!! important "Browser Build Temporarily Unavailable for New Builders and Some Updating Builders"
-    Over the last few weeks, the ability to add identifiers has been degrading and we provided what we thought was a solution - it was not.
-
-    If your build is failing, reach out to see if the failure reason is something we can fix, but otherwise, please wait.
-
-    We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
+!!! check "Browser Build is Working Again"
+    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.
 
 ### `Check Upstream and Keep Alive` Error
 
@@ -228,6 +227,8 @@ If you get an error when building with a browser, you can use this page to figur
 !!! important "Certificate is missing"
     If you get this build error message: `No code signing identity found and can not create a new one because you enabled`, you do not have certificates needed to run the build.
 
+    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.
 
 These are some of the most common errors to date.
@@ -786,23 +787,23 @@ Assuming you have successfully built using the Browser-Build / *GitHub* method b
 ## Handle the `FastLane API Key` Error
 
 !!! important "Browser Build Temporary Issue"
-    Over the last few weeks, the ability to add identifiers has been degrading and we provided what we thought was a solution - it was not.
+    *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 your build is failing, reach out to see if the failure reason is something we can fix, but otherwise, please wait.
+    * 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
 
-    We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
+    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 turns out to be a bigger problem.
+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*.
 
-The rest of this section has some steps that may be needed in the future. Do not follow any of these steps at this time - they will not help until the underlying connection between *GitHub* Actions and *Apple* is working again.
+The rest of this section has some steps that may be needed in the future. Do not follow any of these steps at this time unless a mentor has suggested it or you have a specific error case where one of these steps is recommended.
 
 ## Other Help Steps
 
 These help steps might be needed so the documentation is here.
 
-!!! important "Browser Build Temporary Issue"
-    Do not follow any of these steps a this time - they will not help until the underlying connection between *GitHub* Actions and *Apple* is working again.
-
 ### Delete `Match-Secrets`
 
 Make sure you really need to do this - please [ask a mentor for help](#where-to-get-help-with-browser-build).
@@ -828,6 +829,10 @@ https://github.com/my-name/Match-Secrets
 
 ### Revoke Extra Distribution Certificate
 
+If you have the `ENABLE_NUKE_CERTS` variable added and set to `true`, you should not need this section for most apps. See [Add Variable](prepare-fork.md#add-variable){: target="_blank" } for instructions.
+
+> A few apps still require manual steps for certificate renewal.
+
 This step is done at the *Apple* Developer site; click on this [link](https://developer.apple.com/account/resources/certificates/list).
 
 If you only have *one* Certificate of the `Distribution` type, similar to the graphic shown below, skip ahead to [Delete Invalid Profiles](#delete-invalid-profiles). Ignore any other types of Certificate. Do not delete them.

docs/browser/bb-overview.md

@@ -1,25 +1,18 @@
 ## Build with a Browser
 
-!!! important "Browser Build Temporarily Unavailable for New Builders and Some Updating Builders"
-    Over the last few weeks, the ability to add identifiers has been degrading and we provided what we thought was a solution - it was not.
-
-    This affects a lot of people - not just Open Source Automated Insulin Delivery Apps. We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
-
-    > Building with a Mac still works.
-
-    > If your Identifiers, Certificates and Profiles are up to date, Browser Build still works.
+!!! 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.
 
-    We suggest you check when your most recent build in TestFlight will expire.
+    * 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
 
-    If you are able to build - do it now - that gives you 90 days.
+    > Building with a Mac in not affected.
 
-    To [Build](bb-update.md#build-the-app){: target="_blank" }: 
-    
-    1. Open your repository at github
-    2. Tap on the Action tab and look at the Action List
-    3. If necessary, enable Build Action and run it
-    4. If that succeeds, you have given yourself 90 days
-    5. If that fails, reach out to see if the failure reason is something we can fix, but otherwise, please wait
+    > 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

docs/browser/identifiers.md

@@ -67,10 +67,10 @@ The `Validate Secrets` &nbsp;<span class=notranslate>Action</span>&nbsp; should
 
 ## <code>Add Identifiers</code>
 
-!!! important "Browser Build Temporarily Unavailable for New Builders and Some Updating Builders"
+!!! important "Add Identifiers Temporarily Unavailable"
     The Add Identifiers action does not work at this time.
 
-    We are confident that the connection between *GitHub* Actions and *Apple* will be fixed. For now, please be patient.
+    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)"