Merge pull request #870 from marionbarker/working-docs

Updates for version 3.4.4 and add warning about removing apps from AppConnect

Author: marionbarker

docs/browser/bb-errors.md

@@ -48,7 +48,6 @@ These are some of the most common errors to date.
     * You can delete any branch that starts with the name `alive` and try again
     * See [Automatic Creation of `alive branch`](automatic.md#automatic-creation-of-alive-branch){: target="_blank" }
 
-
 ## Error Annotations
 
 Error annotations are available for the *Loop* app released version 3.4 and later. These were contributed by community volunteers along with the improvements to enable automatic updates and automatic builds.
@@ -188,6 +187,31 @@ Click on the top link to view the record of the failed action as shown in the gr
 
     As your *GitHub* `username` is case-sensitive, use copy and paste.
 
+## Do Not Remove an App
+
+Please do not remove an existing app if you have trouble building a different app. Your build error is not caused by any existing app.
+
+!!! Important "Remove App Warning"
+    If you remove an app and later want to restore that app, you might not be able to.
+
+    Sad and Expensive Scenario:
+
+    1. User removed app with name "My App" and unique bundle ID that includes their TEAMID
+    1. User later decided to restore their app, but in the meantime, someone else has used the name "My App"
+    1. When trying to restore your app, Apple doesn't allow you to change just the name of the app and will not allow you to restore it because someone else has that name, even though your bundle ID is different
+    1. After spending time on the phone with Apple, user's only option was to purchase a new Apple Developer account so they can get a new TEAMID (see steps below) or doing a custom change to the Loop code to modify the bundle ID (no instructions are provided for this - easy to do it wrong)
+
+### New Developer ID with Same GitHub Account
+
+You can use the same GitHub account with a new developer ID. Here are the steps:
+
+1. Update the 4 secrets that are associated with the Apple Account for each repository on the GitHub used for browser build:
+    * TEAMID
+    * FASTLANE_ISSUER_ID
+    * FASTLANE_KEY_ID
+    * FASTLANE_KEY
+1. Once the Secrets are updated, start at the [Identifiers](identifiers.md){:target="_blank"} page and work through the process for each app
+
 ## Action: `Validate Secrets` Errors
 
 For Version 3.4 and later - use [Examine Annotation](#examine-annotation) and read the annotation.

docs/browser/other-apps.md

@@ -147,7 +147,6 @@ The `Validate Secrets` &nbsp;<span class=notranslate>Action</span>&nbsp; should
     * [Action: Validate <code>Secrets</code> Errors](bb-errors.md#action-validate-secrets-errors){: target="_blank" } tells you what to search for in the file
     * Resolve the error and repeat the Action: [Validate <code>Secrets</code>](#validate-secrets)
 
-
 ## Add Identifiers
 
 Near the top middle of your Repository fork, click on the "Actions" tab.
@@ -384,6 +383,18 @@ Refer to the graphic below for the first four steps:
 1. If the process appears to be happening without an error, go do something else for a while. The build should take about 20-30 minutes.
 1. Your app should eventually appear on [App Store Connect](https://appstoreconnect.apple.com/apps){: target="_blank" }.
 
+### Build Errors
+
+Refer to the [Browser Build: Build Errors](bb-errors.md){: target="_blank" } to find your error.
+
+Please do not remove an existing app if you have trouble building a new one. Your build error is not cause by any existing app.
+
+!!! Important "Removing App Warning"
+    If you remove an app and later want to restore that app, you might not be able to.
+
+    For more information, see [Do Not Remove an App](bb-errors.md#do-not-remove-an-app){: target="_blank" }.
+
+
 ## 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).

docs/build/computer.md

@@ -46,9 +46,9 @@ The current release of&nbsp;_<span translate="no">Loop</span>_&nbsp; requires Xc
 
 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.3 as soon as possible.
+> 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.3</span>. If your macOS or Xcode version is higher, you can build with *Mac*.
+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.
 

docs/build/xcode-version.md

@@ -85,9 +85,9 @@ The current release of&nbsp;_<span translate="no">Loop</span>_&nbsp; requires Xc
 
 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.3 as soon as possible.
+> 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.3</span>. If your macOS or Xcode version is higher, you can build with *Mac*.
+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.