Merge pull request nightscout#209 from tmhastings/build-dev

Add Recommendation to Build Dev

Author: MikePlante1

README.md

@@ -1,4 +1,4 @@
-Repository for [Trio documentation (under development)](https://triodocs.org)
+Repository for [Trio documentation (under development)](https://triodocs.org)  
 
 ## Install
 

docs/index.md

@@ -1,9 +1,15 @@
+!!! important "Attention Trio Users"
+    At this time all users should [build the dev branch](install/build/browser/build-dev-with-browser.md) rather than the main branch. We are in the process of merging dev into main. Once that is complete, you will be able to build main again.
+
+    Please read the [Migration Guide](configuration/migration/trio-02x-migration.md) before updating.
+
 !!! important "🚧 Documentation Under Construction 🚧"
 
     This documentation is being released while still under construction. Please, keep in mind the following information:
 
-    - This documentation is for the open testing branch of Trio (`dev` branch). Please review this documentation in preparation for testing Trio 0.5 or newer now that it is publicly available.
+    - This documentation is for the `dev` branch of Trio. Please review this documentation in preparation for using Trio 0.5 or newer.
     - If you are looking for the Trio 0.2.x (`main` branch) documentation, you can still find it here: [0.2.x](0.2.x/index.md)
+        - Please note that Trio 0.2.x is no longer being maintained and we advise all users to move to the `dev` branch.
     - Any page with a ✏️ indicates the information has not yet been updated. The information on those pages should not be referenced at this time.
     - We welcome assistance with proofreading, editing, and updating the information in this documentation. If you would like to contribute to the documentation, please submit issues or PRs [here](https://github.com/nightscout/trio-docs)
     - New educational videos are coming soon.

docs/install/build/browser/browser-build-overview.md

@@ -3,7 +3,7 @@
 Congratulations on choosing to build Trio using your web browser, aka "Browser Build." This documentation provides all the necessary instructions to 
 
 !!! tip "🚧Documentation Under Construction🚧"
-    The Browser Build instructions are still under construction. The steps to build with the browser are overall unchanged from Loop and Trio 0.2.x, so temporarily we advise you to use the [Loopdocs guidance for browser build](https://loopkit.github.io/loopdocs/browser/bb-update/), but replace the Loop GitHub repo with the Trio beta repo.
+    The Browser Build instructions are still under construction. The steps to build with the browser are overall unchanged from Loop and Trio 0.2.x, so temporarily we advise you to use the [Loopdocs guidance for browser build](https://loopkit.github.io/loopdocs/browser/bb-update/), but replace the Loop GitHub repo with the Trio repo.
 
 **Requirements:**
 

docs/install/build/browser/build-dev-with-browser.md

@@ -1,12 +1,10 @@
-## Use Browser Build for Public Beta Version
+## Use Browser Build for Latest Trio
 
 This page is provided to help people currently running the public beta version of Trio.
 
-!!! important "Public Beta"
+!!! important "Dev Branch"
 
-    The public beta is built from the `dev` branch of Trio.
-    
-    This code is undergoing testing and receives rapid updates. Be sure to follow along in Trio Discord and to update frequently (at least weekly).
+    It is now recommended to use the `dev` branch of Trio.
 
     * [Trio Discord Invitation](https://discord.triodocs.org)
 

docs/install/build/mac/build.md

@@ -21,13 +21,13 @@
 
 ## Build Trio with Xcode
 
-!!! important "Public Beta"
+!!! important "Dev Branch"
 
-    The public beta is built from the `dev` branch of Trio.
-    
-    This code is undergoing testing and receives rapid updates. Be sure to follow along in Trio Discord and to download the latest code and update frequently (at least weekly).
+    At this time all users should build the dev branch rather than the main branch. We are in the process of merging dev into main. Once that is complete, you will be able to build main again.
 
-    * [Trio Discord Invitation](https://discord.triodocs.org)
+    Please read the [Migration Guide](../../../configuration/migration/trio-02x-migration.md) before updating.
+    
+    This code is undergoing testing and receives rapid updates. Be sure to follow along in [Trio Discord](https://discord.triodocs.org) and to download the latest code and update frequently (at least weekly).
 
 ### Download Trio with 'Trio Build Select Script'
 
@@ -66,11 +66,11 @@ The Trio Build Select Script is designed to walk you through downloading Trio. P
     ![Screenshot: Build Select Script 2](img/xc-bs2.png){width="682"}
       {align= "center"}
 
-5. Next, the script will prompt you to select which Trio branch you want to download. Unless you are actively contributing to app development by running the public beta, you will type 1 and press return. 
+5. Next, the script will prompt you to select which Trio branch you want to download. Type 1 and press return. 
 
-    !!! important "Public Beta"
+    !!! important "Dev Branch"
 
-        To build the public beta, select 2 at this point to select the `dev` branch. Follow along in Trio discord and be sure to download a new version of code and build an update frequently (at least weekly).
+        Until the `main` branch gets updated past 0.2.x, it is recommended all users build the `dev` branch instead of `main`.
 
     ![Screenshot: Build Select Script 3](img/xc-bs3.png){width="682"}
       {align= "center"}

docs/install/build/mac/img/xc-bs3.png

@@ -8,6 +8,11 @@ Welcome to the installation and update homepage! Here you will find information
 
 Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome-solid-magnifying-glass:, or the menu below to find the section you are looking for.
 
+!!! important "Attention Trio Users"
+    At this time all users should [build the dev branch](build/browser/build-dev-with-browser.md) rather than the main branch. We are in the process of merging dev into main. Once that is complete, you will be able to build main again.
+
+    Please read the [Migration Guide](../configuration/migration/trio-02x-migration.md) before updating.
+
 <div class="grid cards" markdown>
 
 -   __App Requirements__
@@ -23,12 +28,18 @@ Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome
 
     Overview on building Trio using a Mac computer and Xcode
 
+-   __[Build Dev with Browser](build/browser/build-dev-with-browser.md)__
+
+    - - -
+    
+    Overview on building Trio dev branch using a web browser and TestFlight
+    
 -   __[Build with Browser ✏️](build/browser/browser-build-overview.md)__
 
     - - -
 
     🚧Documentation Under Construction🚧
-    Overview on building Trio using a web browser and Test Flight
+    Overview on building Trio using a web browser and TestFlight
 
 -   __[Upgrade ✏️](upgrade.md)__
 

docs/install/index.md

@@ -254,7 +254,7 @@ nav:
               - Build Trio with Xcode: install/build/mac/build.md
               - Build Errors: install/build/mac/build-errors.md
               - Update Trio with Xcode: install/build/mac/update.md
-          - Build Beta with Browser: install/build/browser/build-dev-with-browser.md
+          - Build Dev with Browser: install/build/browser/build-dev-with-browser.md
           - Build with Browser ✏️:
               - Browser Build Overview ✏️: install/build/browser/browser-build-overview.md
               - Create GitHub Account ✏️: install/build/browser/create-github-account.md