Deploying to gh-pages from @ bdf529a 🚀

Author: marionbarker

browser/bb-errors/index.html

@@ -4370,7 +4370,7 @@ <h3 id="error-could-not-decrypt">Error: Could not decrypt<a class="headerlink" h
 <blockquote>
 <p><code>Couldn't decrypt the repo, please make sure you enter the right password</code></p>
 </blockquote>
-<p>If you know you entered the incorrect <code><abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr></code> in your <abbr title="contains project files and each file's revision history">repository</abbr> <code><abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr></code>, go and fix it now and try again.</p>
+<p>If you know you entered the incorrect <code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code> in your <abbr title="contains project files and each file's revision history">repository</abbr> <code><abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr></code>, go and fix it now and try again.</p>
 <p>Otherwise, you need to follow the steps to <a href="#reset-match-secrets">Reset <abbr title="a private repository you must create in your github account, stores keys required to build with github Build Actions">Match-Secrets</abbr></a>.</p>
 <h2 id="action-build-loop-errors">Action: <code>Build Loop</code> Errors<a class="headerlink" href="#action-build-loop-errors" title="Anchor link to this Header on this Page">&para;</a></h2>
 <div class="admonition warning">
@@ -4583,8 +4583,8 @@ <h2 id="reset-match-secrets">Reset <code>Match-Secrets</code><a class="headerlin
 <p>This is not the first thing to try, but sometimes it is the best approach.</p>
 <p>There might be several reasons to do this:</p>
 <ul>
-<li>You lost your <code><abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr></code> and want to build one of the <a href="../other-apps/">Other Apps</a></li>
-<li>You thought you entered the correct <code><abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr></code> but you are getting <a href="#error-could-not-decrypt">Error: Could not decrypt</a></li>
+<li>You lost your <code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code> and want to build one of the <a href="../other-apps/">Other Apps</a></li>
+<li>You thought you entered the correct <code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code> but you are getting <a href="#error-could-not-decrypt">Error: Could not decrypt</a></li>
 <li>You are having trouble renewing your certificates after using Browser Build for a year</li>
 </ul>
 <p>These steps are needed to reset your <code>Match-Secrets</code>:</p>

browser/build-dev-browser/index.html

@@ -1287,6 +1287,15 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#what-happens-in-testflight" class="md-nav__link">
+    <span class="md-ellipsis">
+      What Happens in TestFlight
+    </span>
+  </a>
+  
 </li>
 
     </ul>
@@ -3511,6 +3520,15 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#what-happens-in-testflight" class="md-nav__link">
+    <span class="md-ellipsis">
+      What Happens in TestFlight
+    </span>
+  </a>
+  
 </li>
 
     </ul>
@@ -3663,6 +3681,28 @@ <h2 id="change-default-branch">Change Default <code>Branch</code><a class="heade
 <h2 id="automatic-update-build_1">Automatic Update &amp; Build<a class="headerlink" href="#automatic-update-build_1" title="Anchor link to this Header on this Page">&para;</a></h2>
 <p>The automatic update and build features are available for both the released (<code>main</code>) and development (<code>dev</code>) <abbr title="version of code within a single repository or workspace repository">branch</abbr>, but only for your default <abbr title="version of code within a single repository or workspace repository">branch</abbr>. For any other <abbr title="version of code within a single repository or workspace repository">branch</abbr> name set as your default <abbr title="version of code within a single repository or workspace repository">branch</abbr>, there is no automatic update available but the automatic build will run monthly.</p>
 <p>Be sure to read this page: <a href="../automatic/" target="_blank">Automatic Update &amp; Build</a>.</p>
+<h2 id="what-happens-in-testflight">What Happens in <abbr title="a method to distribute apps without direct connection">TestFlight</abbr><a class="headerlink" href="#what-happens-in-testflight" title="Anchor link to this Header on this Page">&para;</a></h2>
+<p>As soon as you build one version of the app from the <code>dev</code> <abbr title="version of code within a single repository or workspace repository">branch</abbr>, that version number (which is higher than the <code>main</code> <abbr title="version of code within a single repository or workspace repository">branch</abbr>) will show up at the top of the available builds in <abbr title="a method to distribute apps without direct connection">TestFlight</abbr>.</p>
+<p>Suppose you then return to using the <code>main</code> <abbr title="version of code within a single repository or workspace repository">branch</abbr> after your excursion to the <code>dev</code> <abbr title="version of code within a single repository or workspace repository">branch</abbr>.</p>
+<blockquote>
+<p><em>For this example, version 3.4.4 is the released version from the <code>main</code> <abbr title="version of code within a single repository or workspace repository">branch</abbr> and version 3.5.0 is the development version you evaluated.</em></p>
+</blockquote>
+<p>Every time you open <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> on your phone and select the <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app, it will offer the most recent 3.5.0 version to be installed if you just tap <strong>Install</strong>. You might be in a situation where that build is about to expire or you decide you don't want to test this on your looping phone. In some cases, the released version, 3.4.4, might have fixes that are not available in a development <abbr title="version of code within a single repository or workspace repository">branch</abbr>.</p>
+<p>You have your choice:</p>
+<ul>
+<li>You can manually go into <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> each time <code>main</code> is automatically built, Select Previous Builds, then choose 3.4.4 and install the top listing</li>
+<li>You can log in at: <a href="https://appstoreconnect.apple.com/apps" target="_blank">App Store Connect: Apps</a><ul>
+<li>Select your <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app</li>
+<li>Click on the <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> tab</li>
+<li>For each 3.5 build, click on the row for a build<ul>
+<li>Select Expire Build on upper right</li>
+</ul>
+</li>
+<li>This leaves only the released version, 3.4.4 for this example, available in <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> on your phone</li>
+</ul>
+</li>
+</ul>
+<p align="center"><img alt="expire builds with higher version numbers" src="../img/testflight-expire-dev.png" width="700" /></p>
 
 
 

browser/img/testflight-expire-dev.png

@@ -1023,6 +1023,21 @@
     </span>
   </a>
 
+    <nav class="md-nav" aria-label="Make up a Password">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#passphrase-suggestions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Passphrase Suggestions
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
 
         <li class="md-nav__item">
@@ -3552,6 +3567,21 @@
     </span>
   </a>
 
+    <nav class="md-nav" aria-label="Make up a Password">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#passphrase-suggestions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Passphrase Suggestions
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
 
         <li class="md-nav__item">
@@ -3624,7 +3654,7 @@ <h2 id="collect-and-save-secrets">Collect and Save <abbr title="a method to secu
 </ul>
 <p><strong>Created yourself</strong></p>
 <ul>
-<li>a password - make one up and save it (<code><abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr></code>)</li>
+<li>a password - make one up and save it (<code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code>)</li>
 </ul>
 <h2 id="collect-the-four-apple-secrets">Collect the Four <code>Apple Secrets</code><a class="headerlink" href="#collect-the-four-apple-secrets" title="Anchor link to this Header on this Page">&para;</a></h2>
 <details class="abstract">
@@ -3924,7 +3954,20 @@ <h3 id="create-github-personal-access-token">Create <code>GitHub Personal Access
 </li>
 </ol>
 <h2 id="make-up-a-password">Make up a Password<a class="headerlink" href="#make-up-a-password" title="Anchor link to this Header on this Page">&para;</a></h2>
-<p>If you have not already made up a password, do it now and record it as <code><abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr></code>.</p>
+<p>If you have not already made up a password, do it now and record it as <code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code>. Note that if you <a href="../other-apps/" target="_blank">build more than one app</a>, you use the same <code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code> for all the apps. Every app needs to have the same 6 <abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr>.</p>
+<div class="admonition info">
+<p class="admonition-title">What is this Password used for?</p>
+<p>The <code><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></code> is a special password called a <em>passphrase</em> that is used to encrypt and decrypt your certificates from <em>Apple</em> so they can be used when building with <em><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr></em>; it helps keeps your certificates secret and safe.</p>
+<p>A <em>passphrase</em> is a little different from a regular password. A password is what you usually use to log in to a website or game. A <em>passphrase</em> is a secret code that helps protect important files by adding an extra layer of security when files are encrypted.</p>
+</div>
+<h3 id="passphrase-suggestions"><em>Passphrase</em> Suggestions<a class="headerlink" href="#passphrase-suggestions" title="Anchor link to this Header on this Page">&para;</a></h3>
+<p>To make a <em>passphrase</em> that is hard to guess and keeps your certificates safe:</p>
+<ul>
+<li>Use at least 15 characters (20 is even better) and you can include spaces</li>
+<li>Mix in big letters, small letters, numbers, and symbols like $ or #</li>
+<li>Don’t use words or numbers that people might guess, like your name or birthday</li>
+</ul>
+<p>If you already created a <abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr> that does not meet the criteria listed above, no worries, you are protecting an <em>Apple</em> developer certificate - not the family fortune. That information is provided for new builders who want guidance.</p>
 <h2 id="next-step">Next Step<a class="headerlink" href="#next-step" title="Anchor link to this Header on this Page">&para;</a></h2>
 <p>The next step is to <a href="../prepare-fork/">Prepare your Fork (Copy of LoopWorkspace)</a>.</p>
 

browser/secrets/index.html

@@ -3413,7 +3413,7 @@ <h1 id="glossary">Glossary<a class="headerlink" href="#glossary" title="Anchor l
 <p><strong><span translate="no"><abbr title="One of 6 Secrets: Key ID provided when you create an API key in App Store Connect; it is associated with the FASTLANE_KEY">FASTLANE_KEY_ID</abbr></span></strong>&nbsp; (<abbr title="One of 6 Secrets: Key ID provided when you create an API key in App Store Connect; it is associated with the FASTLANE_KEY">FASTLANE_KEY_ID</abbr>): One of 6 <abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr>: Key ID provided when you create an <abbr title="Application Programming Interface">API</abbr> key in App Store Connect; it is associated with the <abbr title="One of 6 Secrets: Really long key (several lines); it and FASTLANE_KEY_ID are generated together">FASTLANE_KEY</abbr></p>
 <p><strong><span translate="no"><abbr title="One of 6 Secrets: Really long key (several lines); it and FASTLANE_KEY_ID are generated together">FASTLANE_KEY</abbr></span></strong>&nbsp; (<abbr title="One of 6 Secrets: Really long key (several lines); it and FASTLANE_KEY_ID are generated together">FASTLANE_KEY</abbr>): One of 6 <abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr>: Really long key (several lines); it and <abbr title="One of 6 Secrets: Key ID provided when you create an API key in App Store Connect; it is associated with the FASTLANE_KEY">FASTLANE_KEY_ID</abbr> are generated together</p>
 <p><strong><span translate="no"><abbr title="One of 6 Secrets: Generated with your GitHub account; set it to never expire">GH_PAT</abbr></span></strong>&nbsp; (<abbr title="One of 6 Secrets: Generated with your GitHub account; set it to never expire">GH_PAT</abbr>): One of 6 <abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr>: Generated with your <abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr> account; set it to never expire</p>
-<p><strong><span translate="no"><abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr></span></strong>&nbsp; (<abbr title="One of 6 Secrets: password you make up but must save and cannot change without deleting the Match-Secrets repository">MATCH_PASSWORD</abbr>): One of 6 <abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr>: password you make up but must save and cannot change without deleting the <abbr title="a private repository you must create in your github account, stores keys required to build with github Build Actions">Match-Secrets</abbr> <abbr title="contains project files and each file's revision history">repository</abbr></p>
+<p><strong><span translate="no"><abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr></span></strong>&nbsp; (<abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr>): One of 6 <abbr title="a method to securely embed personal information into your fork of LoopWorkspace to enable GitHub to have access required to build Loop">Secrets</abbr>: Git repo encryption passphrase, used to encrypt the <abbr title="a private repository you must create in your github account, stores keys required to build with github Build Actions">Match-Secrets</abbr> <abbr title="contains project files and each file's revision history">repository</abbr> when it is created. You must save and use the same <abbr title="One of 6 Secrets: Git repo encryption passphrase, used to encrypt the Match-Secrets repository when it is created. You must save and use the same MATCH_PASSWORD for every repository if you build multiple apps.">MATCH_PASSWORD</abbr> for every <abbr title="contains project files and each file's revision history">repository</abbr> if you build multiple apps.</p>
 <p><strong><span translate="no"><abbr title="Secure Hash Algorithm 1; used to generate an alphanumeric code for commits in git (github)">SHA-1</abbr></span></strong>&nbsp; (<abbr title="Secure Hash Algorithm 1; used to generate an alphanumeric code for commits in git (github)">SHA-1</abbr>): Secure Hash Algorithm 1; used to generate an alphanumeric code for commits in <abbr title="a tool for version control">git</abbr> (github)</p>
 <p><strong><span translate="no"><abbr title="associate a Developer ID with an app; must sign all targets for a given app">Sign Targets</abbr></span></strong>&nbsp; (<abbr title="associate a Developer ID with an app; must sign all targets for a given app">Sign Targets</abbr>): associate a Developer ID with an app; must sign all targets for a given app</p>
 <p><strong><span translate="no"><abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr></span></strong>&nbsp; (<abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr>): for <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr>, <abbr title="for Loop, submodules are repositories defined in the Workspace repository that are required to build the app">submodules</abbr> are repositories defined in the <abbr title="a grouping of several repositories into a complete package">Workspace</abbr> <abbr title="contains project files and each file's revision history">repository</abbr> that are required to build the app</p>