Deploying to gh-pages from @ 296d892 🚀

Author: marionbarker

browser/bb-errors/index.html

@@ -1098,6 +1098,24 @@
     <nav class="md-nav" aria-label="Help with Errors">
       <ul class="md-nav__list">
 
+          <li class="md-nav__item">
+  <a href="#where-to-get-help-with-browser-build" class="md-nav__link">
+    <span class="md-ellipsis">
+      Where to Get Help with Browser Build
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#what-information-is-needed-for-help" class="md-nav__link">
+    <span class="md-ellipsis">
+      What Information is Needed for Help
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#most-common-mistakes" class="md-nav__link">
     <span class="md-ellipsis">
@@ -3679,6 +3697,24 @@
     <nav class="md-nav" aria-label="Help with Errors">
       <ul class="md-nav__list">
 
+          <li class="md-nav__item">
+  <a href="#where-to-get-help-with-browser-build" class="md-nav__link">
+    <span class="md-ellipsis">
+      Where to Get Help with Browser Build
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#what-information-is-needed-for-help" class="md-nav__link">
+    <span class="md-ellipsis">
+      What Information is Needed for Help
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#most-common-mistakes" class="md-nav__link">
     <span class="md-ellipsis">
@@ -4035,11 +4071,41 @@
   <h1>Errors with Browser</h1>
 
 <h2 id="help-with-errors">Help with Errors<a class="headerlink" href="#help-with-errors" title="Anchor link to this Header on this Page">&para;</a></h2>
-<p>If you get an error when building with a browser, use this page to figure out what to do.</p>
-<p>If you are still unsuccessful, then post your request for help along with the link to your <abbr title="contains project files and each file's revision history">repository</abbr>. For example - this link is used to test the build instructions and generate figures for LoopDocs. You replace your <abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr> username where you see <code>loopdocs-tester</code>:</p>
+<div class="admonition important">
+<p class="admonition-title">Get Help, Not Frustrated</p>
+<p>For first-time builders, there are a lot of one-time steps that all have to be correct and many screens look similar.</p>
+<p>If you are updating your build or renewing certificates, the process can be confusing and some error messages can be misleading.</p>
+<p>If you are having trouble, don't hesitate to ask for help.</p>
+<p>Please do NOT:</p>
+<ul>
+<li>Spend hours in frustration</li>
+<li>Rename or delete a <abbr title="contains project files and each file's revision history">repository</abbr></li>
+<li>Delete your <abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr> account</li>
+<li>Remove your App from App Store Connect</li>
+</ul>
+</div>
+<h3 id="where-to-get-help-with-browser-build">Where to Get Help with Browser Build<a class="headerlink" href="#where-to-get-help-with-browser-build" title="Anchor link to this Header on this Page">&para;</a></h3>
+<p>These are two places to ask for help, but please choose only one. You may get a faster response from Facebook, but there are mentors on both sites:</p>
+<ul>
+<li><a href="https://www.facebook.com/groups/LOOPandLEARN" target="_blank">LoopandLearn Facebook Group</a></li>
+<li><a href="https://loop.zulipchat.com/#narrow/channel/148543-Loop/topic/Browser.20Build" target="_blank">Zulipchat: <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr>: Build Help</a></li>
+</ul>
+<h3 id="what-information-is-needed-for-help">What Information is Needed for Help<a class="headerlink" href="#what-information-is-needed-for-help" title="Anchor link to this Header on this Page">&para;</a></h3>
+<ol>
+<li>
+<p>Your <abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr> username (required):</p>
 <ul>
-<li><a href="https://github.com/loopdocs-tester/LoopWorkspace" target="_blank">https://<abbr title="an online service for storing repositories, accessible from a browser">github.com</abbr>/loopdocs-tester/LoopWorkspace</a></li>
+<li>You can also provide a link to your <abbr title="contains project files and each file's revision history">repository</abbr> like the example, but substitute your username for <code>USERNAME</code></li>
+<li>If you are building an app other than <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr>, replace LoopWorkspace with the app <abbr title="contains project files and each file's revision history">repository</abbr> name</li>
 </ul>
+<div class="highlight"><pre><span></span><code>https://github.com/USERNAME/LoopWorkspace
+</code></pre></div>
+</li>
+<li>
+<p>A brief summary of the step you are on and what isn't working.</p>
+</li>
+</ol>
+<p>That's all we need to get started.</p>
 <p>Mentors can go to your public&nbsp;<em><span translate="no"><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr> <abbr title="contains project files and each file's revision history">repository</abbr></span></em>, make sure your code is up to date, examine your customizations (if any), then click on the Action tab and view your log files directly.</p>
 <ul>
 <li>Do not copy from the log file and post the words</li>
@@ -4050,8 +4116,8 @@ <h2 id="help-with-errors">Help with Errors<a class="headerlink" href="#help-with
 <p>If you've been around the <abbr title="Do it yourself, a common acronym for the open-source software community (and the maker community)">DIY</abbr> community for a while, you know the mantra about screenshots. Well, when using a browser to build, <strong>screenshots are close to useless</strong>.</p>
 <p>All that is needed to assist is your link or as a bare minimum your <em><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> <strong>username</strong>.</p>
 </div>
-<p>But first - try to diagnose it yourself using this page.</p>
 <h3 id="most-common-mistakes">Most Common Mistakes<a class="headerlink" href="#most-common-mistakes" title="Anchor link to this Header on this Page">&para;</a></h3>
+<p>If you get an error when building with a browser, you can use this page to figure out what to do - but don't be afraid to <a href="#help-with-errors">ask for help</a>.</p>
 <div class="admonition warning">
 <p class="admonition-title">Just updated?</p>
 <p>If you just updated to version 3.4 from version 3.2.x, you must add a new Identifier.</p>

browser/bb-overview/index.html

@@ -3704,9 +3704,19 @@ <h2 id="install-on-phone">Install on Phone<a class="headerlink" href="#install-o
 <li><a href="../phone-install/" target="_blank">Install on Phone</a></li>
 </ul>
 <h2 id="what-if-i-get-stuck">What if I get stuck?<a class="headerlink" href="#what-if-i-get-stuck" title="Anchor link to this Header on this Page">&para;</a></h2>
-<p>Try to:</p>
+<div class="admonition important">
+<p class="admonition-title">How to Ask for Help</p>
+<p>First time setup should take several hours, but if you are having trouble:</p>
 <ul>
-<li>Scroll back in the directions and see if you missed a paragraph or step</li>
+<li><a href="../bb-errors/#help-with-errors" target="_blank">Click here to find help</a>.</li>
+</ul>
+</div>
+<p>If you want to solve it yourself, try to:</p>
+<ul>
+<li>Scroll back in the directions and see if you missed a paragraph or step<ul>
+<li>Be sure you are copying the exact <strong>names</strong> needed for each step or clicking on the <strong>link</strong> associated with a particular step - many pages look similar</li>
+</ul>
+</li>
 <li>Compare your display with the <span>graphics in <em>LoopDocs</em></span><ul>
 <li>Is something different or does yours have an error message?</li>
 <li>Does the <a href="../bb-errors/" target="_blank">Error</a> message guide you to the problem and solution?</li>

browser/bb-update/index.html

@@ -3875,10 +3875,23 @@ <h3 id="how-to-update-or-rebuild">How to Update or Rebuild<a class="headerlink"
 <li><a href="https://www.youtube.com/watch?v=0ipTsiqbbrQ" target="_blank">How to Update and Rebuild <abbr title="Do it yourself, a common acronym for the open-source software community (and the maker community)">DIY</abbr> <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> with a Web Browser</a></li>
 </ul>
 </div>
+<div class="admonition important">
+<p class="admonition-title">How to Ask for Help</p>
+<p>Updating with Browser Build should be pretty fast and often automatic. Updating certificates (once a year) can sometimes be tricky.</p>
+<p>If you are having trouble:</p>
+<ul>
+<li><a href="../bb-errors/#help-with-errors" target="_blank">Click here to find help</a>.</li>
+</ul>
+</div>
 <h2 id="accept-agreements">Accept Agreements<a class="headerlink" href="#accept-agreements" title="Anchor link to this Header on this Page">&para;</a></h2>
 <blockquote>
 <p>This is Step 1 of 6 - it may not always be necessary, but please check every time.</p>
 </blockquote>
+<div class="admonition warning">
+<p class="admonition-title">Wait After You Agree</p>
+<p>It typically takes 15 minutes before your updated agreement is available so you can complete your build.</p>
+<p>If your build with browser fails, wait longer. An hour wait was reported by one person.</p>
+</div>
 <p>Sign in to your <a href="https://developer.apple.com/account" target="_blank">Apple Developer account</a>. If there are agreements you have not accepted, you will get errors when you try to Build that indicate your <em>Apple</em> <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> are incorrect - that is very unlikely. You may also need to update your credit card information if it has changed, for example, if there is a new expiration date.</p>
 <ul>
 <li>For an update, you do not need to modify the <code><abbr title="One of 6 Secrets: the issuer ID is associated with your Apple Developer ID and never changes">FASTLANE_ISSUER_ID</abbr></code>, <code><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></code> or <code><abbr title="One of 6 Secrets: Really long key (several lines); it and FASTLANE_KEY_ID are generated together">FASTLANE_KEY</abbr></code></li>
@@ -3901,11 +3914,6 @@ <h2 id="accept-agreements">Accept Agreements<a class="headerlink" href="#accept-
 </ul>
 </li>
 </ul>
-<div class="admonition warning">
-<p class="admonition-title">Wait After You Agree</p>
-<p>It typically takes 15 minutes before your updated agreement is available so you can complete your build.</p>
-<p>If your build with browser fails, wait longer. An hour wait was reported by one person.</p>
-</div>
 <h2 id="renew-certificate">Renew <abbr title="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr><a class="headerlink" href="#renew-certificate" title="Anchor link to this Header on this Page">&para;</a></h2>
 <blockquote>
 <p>This is Step 2 of 6 - it is only needed once a year - you should get an email from Apple 30 days before your <code>Distribution Certificate</code> expires. (Don't worry if you did not see the email.)</p>
@@ -3921,10 +3929,13 @@ <h2 id="renew-certificate">Renew <abbr title="Apple certificate is used to sign
 <p>This is only a summary - please follow the detailed steps below carefully.</p>
 <ul>
 <li>
-<p>Delete all your <code>Distribution Certificates</code>. Apple only allows you to have 2 of these. So get rid of the old ones so you will be able to create a new one that will last a full year. (Step 1 below.)</p>
+<p>Delete all your certificates that say the type is <code>Distribution</code>. Apple only allows you to have 2 of these. So get rid of the old ones so you will be able to create a new one that will last a full year. (Step 1 below.)</p>
+</li>
+<li>
+<p>Some people have <code>Distribution Managed</code> types listed. These are cloud-managed. An internet search finds this quote: "My general approach to cloud-managed certificates is to ignore them and let Apple’s infrastructure do its thing."</p>
 </li>
 <li>
-<p>The <abbr title="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr> in question is embedded in your <code>Match-Secrets repository</code>. In order to proceed, you need to remove the old certificate from <code>Match-Secrets</code>. Later this will be automated and can be done without modifying your <code>Match-Secrets repository</code>, but for now the easiest way to do that is to just delete the <code>certs/distribution</code> folder in your current <code>Match-Secrets repository</code>.</p>
+<p>The <abbr title="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr> in question is embedded in your <code>Match-Secrets repository</code>. In order to proceed, you need to remove the old certificate from <code>Match-Secrets</code>.</p>
 </li>
 <li>
 <p>Finally, for every app that you build with this method, you need to run <code>Create Certificates</code> for that app. (Step 4 below.)</p>
@@ -3939,13 +3950,14 @@ <h3 id="manual-steps-to-renew-your-distribution-certificate">Manual Steps to Ren
 <ol>
 <li>Use this link to view your <a href="https://developer.apple.com/account/resources/certificates/list" target="_blank">Apple Developer Certificates</a><ul>
 <li>If your screen shows no Certificates and you see a message "Getting Started with Certificates", your certificate already expired and was removed by <em>Apple</em>; so skip ahead to Step 2: Navigate to your <code>Match-Secrets</code> Repository</li>
-<li>Carefully examine the <code>Type</code> column - do <strong>not</strong> delete a <code>Development Certificate</code><ul>
-<li>If you do not have any rows that say <code>Distribution Certificate</code>, your certificate already expired and was removed by <em>Apple</em>; so skip ahead to Step 2</li>
+<li>Carefully examine the <code>Type</code> column - do <strong>not</strong> delete a certificate with type of <code>Development</code><ul>
+<li>If you do not have any rows that say the type is <code>Distribution</code>, your certificate already expired and was removed by <em>Apple</em>; so skip ahead to Step 2</li>
 <li>If your certificate has an expiration date several months in the future - you can wait and renew your certificate later; skip ahead to <a href="#update-fork">Update <code>Fork</code></a></li>
 </ul>
 </li>
-<li>Click each row that has a <code>Distribution Certificate</code> and revoke it</li>
+<li>Click each row that has a type of <code>Distribution</code> and revoke it</li>
 <li>You will get an email informing you the certificate was revoked</li>
+<li>You can ignore rows with a type of <code>Distribution Managed</code></li>
 </ul>
 </li>
 <li>

browser/certs/index.html

@@ -3470,9 +3470,9 @@ <h3 id="success">Success<a class="headerlink" href="#success" title="Anchor link
 <h3 id="failure">Failure<a class="headerlink" href="#failure" title="Anchor link to this Header on this Page">&para;</a></h3>
 <p>If this action fails, head over to the errors page. Review these links, identify and fix your error or ask for help.</p>
 <ul>
+<li><a href="../bb-errors/#help-with-errors" target="_blank">How to Ask for Help</a></li>
 <li><a href="../bb-errors/#most-common-mistakes" target="_blank">Most Common Mistakes</a></li>
 <li><a href="../bb-errors/#action-create-certificates-errors" target="_blank">Create Certificates Errors</a>.</li>
-<li><a href="../bb-errors/#help-with-errors" target="_blank">How to Ask for Help</a></li>
 </ul>
 
 

browser/identifiers/index.html

@@ -3473,6 +3473,10 @@ <h2 id="validate-secrets">Validate <code><abbr title="a method to securely embed
 </ul>
 </li>
 </ul>
+<div class="admonition important">
+<p class="admonition-title">Ask For Help Early</p>
+<p>Please if you are having trouble - <a href="../bb-errors/#help-with-errors" target="_blank">ask for help early by clicking on this link</a>.</p>
+</div>
 <div class="admonition tip">
 <p class="admonition-title">Pro Tip: Validate <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>
 <p>The Action <code>Validate Secrets</code> is run every time you do any other action. Technically, you never have to run the action by itself - you could start with <code>Add Identifiers</code>.</p>
@@ -3525,6 +3529,10 @@ <h2 id="add-identifiers"><code>Add <abbr title="names of modules found on your A
 </ul>
 </li>
 </ul>
+<div class="admonition important">
+<p class="admonition-title">Ask For Help Early</p>
+<p>Please if you are having trouble - <a href="../bb-errors/#help-with-errors" target="_blank">ask for help early by clicking on this link</a>.</p>
+</div>
 <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-app/">Prepare the App</a>.</p>
 

browser/intro-summary/index.html

@@ -3601,7 +3601,14 @@ <h2 id="summary-of-steps">Summary of Steps<a class="headerlink" href="#summary-o
 </ul>
 </details>
 <h2 id="tips-and-tricks">Tips and Tricks<a class="headerlink" href="#tips-and-tricks" title="Anchor link to this Header on this Page">&para;</a></h2>
-<p>The steps to configure for building with a browser requires a lot of focused attention. Take it in steps and take breaks as needed. Some people prefer a video. Some people prefer more detailed steps on a webpage and others only high-level steps. </p>
+<p>The steps to configure for building with a browser require a lot of focused attention. Take it in steps and take breaks as needed. Some people prefer a video. Some people prefer more detailed steps on a webpage and others only high-level steps.</p>
+<div class="admonition important">
+<p class="admonition-title">How to Ask for Help</p>
+<p>First time setup should take several hours, but if you are having trouble don't get frustrated:</p>
+<ul>
+<li><a href="../bb-errors/#help-with-errors" target="_blank">Click here to find help</a>.</li>
+</ul>
+</div>
 <h3 id="the-short-version">The Short Version<a class="headerlink" href="#the-short-version" title="Anchor link to this Header on this Page">&para;</a></h3>
 <p>Complete instructions are found at this link for those comfortable with using <em><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> and navigating the <em>Apple Developer</em> and <em>Apple App Connect</em> pages.</p>
 <ul>

browser/prepare-app/index.html

@@ -3568,6 +3568,11 @@ <h2 id="prepare-the-app">Prepare the App<a class="headerlink" href="#prepare-the
 <li><a href="#configure-identifiers-for-loop" target="_blank">Configure</a> them to associate the correct <abbr title="a unique identifier that Apple users for a given app, yours has your TEAMID embedded in it, group.com.TEAMID.loopkit.LoopGroup">App Group</abbr> with specific identifiers </li>
 <li><a href="#create-loop-app-in-app-store-connect" target="_blank">Create</a> the <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> App.</li>
 </ol>
+<p>Some people get confused on this page. Many of the links look similar but are actually different pages at <em>Apple</em>.</p>
+<div class="admonition important">
+<p class="admonition-title">Ask For Help Early</p>
+<p>Please if you are having trouble - <a href="../bb-errors/#help-with-errors" target="_blank">ask for help early by clicking on this link</a>.</p>
+</div>
 <h2 id="configure-identifiers-for-loop">Configure <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> for <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr><a class="headerlink" href="#configure-identifiers-for-loop" title="Anchor link to this Header on this Page">&para;</a></h2>
 <details class="tip" open="open">
 <summary>Background Information (Click to open/close)</summary>