Update Companion App Documentation and Update Core Concepts Testing

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/configuration/index.md

@@ -19,10 +19,4 @@ Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome
 
     A compilation of all settings found in Trio with explanations and definitions
 
--   __[Migration Guides](migration/index.md)__
-
-    - - -
-
-    Guidance on locating and identifying the necessary settings for onboarding
-
 </div>

docs/configuration/new-user-setup.md

@@ -60,10 +60,10 @@ Trio has an Onboarding Wizard that walks you through these steps when you first
 !!! tip "Need help finding these settings in your current DIY app?"
     If you are coming from another Open Source Automated Insulin Dosing (OS-AID) app, these guides may help you with finding these settings in your previous app and inputing them into Trio.
 
-    - [Trio 0.2.x](migration/trio-02x-migration.md)
-    - [iAPS](migration/iaps-migration.md)
-    - [Loop](migration/loop-migration.md)
-    - [AndroidAPS](migration/aaps-migration.md)
+    - [Trio 0.2.x](../usage/migration/trio-02x-migration.md)
+    - [iAPS](../usage/migration/iaps-migration.md)
+    - [Loop](../usage/migration/loop-migration.md)
+    - [AndroidAPS](../usage/migration/aaps-migration.md)
 
 ## **Step 1:** Prepare Trio
 

docs/configuration/settings/algorithm/dynamic-settings.md

@@ -1,5 +1,8 @@
 # Dynamic Settings
 
+!!!information "Using Dynamic ISF"
+    For more information about using Dynamic ISF with Trio, head over to the [Using Dynamic ISF](../../../usage/explained/dynamic-isf.md) section of the docs
+
 ## Dynamic ISF: Logarithmic
 **Default:** _Disabled_
 
@@ -229,6 +232,8 @@ See [Weighted Average of TDD](#weighted-average-of-tdd) setting to understand ho
 
 ## Logarithmic Desmos Graphs
 
+For information on how to use and understand the Desmos Graphs, go to the [Understanding Desmos Graphs](../../../usage/explained/desmos-explained.md) section of the docs.
+
 [Click here to view a graph depicting the logarithmic formula in mg/dL](https://www.desmos.com/calculator/0frb0mvjzr)
 
 [Click here to view a graph depicting the logarithmic formula in mmol/L](https://www.desmos.com/calculator/2iu4cgtqln)
@@ -237,6 +242,8 @@ See [Weighted Average of TDD](#weighted-average-of-tdd) setting to understand ho
 
 ## Sigmoid Desmos Graphs
 
+For information on how to use and understand the Desmos Graphs, go to the [Understanding Desmos Graphs](../../../usage/explained/desmos-explained.md) section of the docs.
+
 [Click here to view a graph depicting the sigmoid formula in mg/dL](https://www.desmos.com/calculator/zhc6k580qm)
 
 [Click here to view a graph depicting the sigmoid formula in mmol/L](https://www.desmos.com/calculator/ihjjxwipbt)

docs/configuration/settings/devices/cgm.md

@@ -161,7 +161,7 @@ Continue to [Connect Watch](smart-watch.md) _OR_ return to [New User Setup](../.
 - - -
 
 ### xDrip4iOS
-To use xDrip4iOS as a CGM source, you must build it yourself with the same Apple Developer account you used to build your Trio app. You cannot use Shuggah or a version distributed by someone else's TestFlight. Please see the following for instructions on how to build xDrip4iOS yourself: [link](../../../install/ecosystem/xdrip4ios.md)
+To use xDrip4iOS as a CGM source, you must build it yourself with the same Apple Developer account you used to build your Trio app. You cannot use Shuggah or a version distributed by someone else's TestFlight. Please see the following for instructions on how to build xDrip4iOS yourself: [link](../../../usage/ecosystem/xdrip4ios.md)
 
 However, if you are using Dexcom G6 or ONE with xDrip4iOS, you can choose the Dexcom G6 option in Trio rather than xDrip4iOS, and Trio will intercept the glucose readings even if you're using Shuggah or someone else's TestFlight of xDrip4iOS.
 

docs/configuration/settings/devices/index.md

@@ -6,38 +6,6 @@
 
 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.
 
-## Verify Device Compatibility
-
-<div class="grid cards" markdown>
-
--   __[Phones](../../../install/build/requirements/devices/iphone.md#compatible-phones)__
-
-    - - -
-
-    List of compatible phones
-
--   __[Watches](../../../install/build/requirements/devices/iphone.md/#apple-watch)__
-
-    - - -
-
-    List of compatible watches
-
--   __[Pumps](../../../install/build/requirements/devices/pump.md#compatible-pumps)__
-
-    - - -
-
-    List of compatible insulin pumps
-
--   __[CGMs](../../../install/build/requirements/devices/cgm.md#compatible-cgm)__
-
-    - - -
-
-    List of compatible continuous glucose monitors (CGMs)
-
-</div>
-
-## Add Devices
-
 <div class="grid cards" markdown>
 
 -   __[Insulin Pump](pump.md)__

docs/configuration/settings/features/index.md

@@ -30,7 +30,7 @@ Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome
 
     - - -
 
-    Allow remote control and find the shared secret used in Loop Follow
+    Allow remote control and find the shared secret used in LoopFollow
 
 -   __[User Interface](user-interface.md)__
 
@@ -43,5 +43,10 @@ Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome
     - - -
 
     Change the Trio app icon
+
+-   __[App Diagnostics](app-diagnostics.md)__
+
+    - - -
 
+    Enable or Disable sharing anonymized data sharing
 </div>

docs/configuration/settings/features/remote-control.md

@@ -1,38 +1,10 @@
 ## Remote Control Overview
 
-Trio can accept remote commands from *Nightscout* or from *LoopFollow*. There are a variety of options, but the final control of whether remote commands will be enacted rests with the Trio user. They can enable or disable remote control.
+Trio can accept remote commands from [*LoopFollow*](../../../usage/ecosystem/loopfollow.md) or from [*Nightscout*](../../../usage/ecosystem/nightscout-app.md). There are a variety of options, but the final control of whether remote commands will be enacted rests with the Trio user. They can enable or disable remote control.
 
-!!! warning "*Nightscout* version must be 15.0.2 or newer"
-    To properly display the OpenAPS pill with Trio 0.5.x (or newer), your *Nightscout* version must be 15.0.2 (or newer). If you do not see the expected treatments or pills in the *Nightscout* dashboard, follow the steps to [Configure for OpenAPS](#configure-for-openaps).
+The recommended approach is to use Trio 0.5.x (or newer) with the *LoopFollow* app to use the Trio Remote Control setting.
 
-The most powerful arrangement, for Trio 0.5.x (or newer), is to configure the *LoopFollow* app to use the Trio Remote Control (TRC) setting.
-
-The limited use of remote control with *Nightscout*, i.e., entry of Carb Correction and Temporary Targets when Careportal is authenticated, continues to be supported with Trio.
-
-| *Nightscout* URL or App | Options|
-|:--|:--|
-| ***Careportal*** | Carb Correction<br>Temporary Target<br>Temporary Target Cancel |
-
-Additional remote capabilities are offered for Trio using the *LoopFollow* app with these versions:
-
-* Trio 0.5.x (or newer)
-* *LoopFollow* version 2.4.0 (or newer)
-
-
-| *LoopFollow* Remote Type | Options|
-|:--|:--|
-| ***Nightscout*** | Set and Cancel Temp Target |
-| **Trio Remote Control** | Meal (Carbs or Carbs & Bolus)<br>Bolus<br>Temp Target<br>Overrides |
-
-??? question "How does this differ from Trio 0.2.x?"
-    Trio can use *Nightscout* Careportal to enter `Carb Correction`, and start and cancel `Temporary Target`.
-
-    * This was available in Trio 0.2.x and continues to be available in Trio 0.5.x (or newer).
-
-    Trio 0.2.x supported other remote options (using announcements via Careportal). 
-
-    * Those options were replaced by the more secure Trio Remote Control for Trio 0.5.x (or newer)
-    * **Using announcements to provide remote control of the Trio phone is no longer supported**
+The use of remote control with *Nightscout*, i.e., entry of Carb Correction and Temporary Targets when Careportal is authenticated, is supported with Trio, but the ability is limited and there can be delays in confirmation.
 
 - - -
 
@@ -544,17 +516,9 @@ Overrides modify your therapy settings by percentage:
 | **Carb Ratios** | Percentage multiplier | 75% = less insulin per carb |
 | **Target Glucose** | Override target value | Completely replaces normal target |
 
-**Example "Exercise" Override**:
-- ISF: 150% (more sensitive, less insulin)
-- Basal: 75% (reduced basal delivery)
-- CR: 120% (less insulin for carbs)
-- Target: 140 mg/dL (higher target to prevent lows)
-
-**Example "Sick Day" Override**:
-- ISF: 50% (more resistant, more insulin)
-- Basal: 150% (increased basal delivery)
-- CR: 80% (more insulin for carbs)
-- Target: 110 mg/dL (tighter control)
+!!!important
+    Using an override target glucose **will not** trigger the Target Adjustments (`Low Temp Target Lowers Sensitivity` or `High Temp Target Raises Sensitivity`).
+    Those can only be triggered using a separate Temp Target.
 
 #### Override Preset Name Matching
 
@@ -732,5 +696,5 @@ Other signatures that you need to [force the update](#update-profile) are shown
 
 ## Build *LoopFollow*
 
-Follow this link to the [LoopFollow](../../../install/ecosystem/loop-follow.md){: target="_blank" } build instructions.
+Follow this link to the [LoopFollow](../../../usage/ecosystem/loopfollow.md){: target="_blank" } build instructions.
 

docs/configuration/settings/services/apple-health.md

@@ -1,4 +1,4 @@
-# Apple Health ✏️
+# Apple Health
 
 !!! info
     Apple Health is optional

docs/configuration/settings/services/index.md

@@ -1,30 +1,27 @@
 # Services
 
-![Trio Logo](../../../assets/images/trio-logo.png){ .skip-lightbox width="75" align="left" } Welcome to the Services homepage! This section provides you with additional information on the services built into the Trio app. There are also [Companion Apps](../../../install/ecosystem/index.md) that will work alongside Trio.  
+![Trio Logo](../../../assets/images/trio-logo.png){ .skip-lightbox width="75" align="left" } Welcome to the Services homepage! This section provides you with additional information on the services built into the Trio app. There are also [Companion Apps](../../../usage/ecosystem/index.md) that will work alongside Trio.  
 
 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.
 
 <div class="grid cards" markdown>
 
--   __[Nightscout ✏️](nightscout.md)__
+-   __[Nightscout](nightscout.md)__
 
     - - -
 
-    🚧Documentation Under Construction🚧
     Connect your nightscout, import settings, backfill glucose, and more
 
--   __[Tidepool ✏️](tidepool.md)__
+-   __[Tidepool](tidepool.md)__
 
     - - -
 
-    🚧Documentation Under Construction🚧
     Connect Tidepool
 
--   __[Apple Health ✏️](apple-health.md)__
+-   __[Apple Health](apple-health.md)__
 
     - - -
-
-    🚧Documentation Under Construction🚧
+
     Connect Apple Health
 
 </div>

docs/configuration/settings/services/nightscout.md

@@ -1,30 +1,67 @@
-# Visualization and Monitoring ✏️
+# Nightscout: Visualization and Monitoring
 
 !!! tip "Highlights"
     - *Nightscout* is optional but encouraged
     - *Nightscout* is a useful tool for data analysis and followers
     - Create a *Nightscout* server and input your URL and `API_SECRET` in *Trio*.  
       Test the connection and enable `Allow Uploading to Nightscout`.
 
-## Nightscout Introduction
+## Configuration
 
-[Nightscout](http://nightscout.info) (NS) is an open-source project that allows real-time access to CGM data via a personal website, smartwatch viewers, or apps and widgets available for smartphones. Setting up a *Nightscout* web app is recommended to visualize your *Trio* closed loop. 
+### Step 1: Enable Nightscout in Trio
 
-*Nightscout* allows a user to upload CGM data from various sources to an online database and cloud computing service. The information is then processed and displayed visually as a graph. Plugins also allow more information to be shown about *Trio*. 
+<div class="grid" markdown>
 
-Even if you don't choose to share your *Nightscout* site
-with another person, it will be helpful for you to visualize what the loop is doing and what it's been doing, plus generate helpful reports for understanding your data.
+1. Open Trio and navigate to **Settings → Services → Nightscout → Connect**
+2. Enter your Nightscout **URL** (without trailing slash)
+    - Example: `https://yoursite.herokuapp.com`
+3. Enter your [**API Secret**](https://nightscout.github.io/nightscout/setup_variables/#api-secret-nightscout-password)
+    - This is the same secret you configured in Nightscout
+    - Stored securely in iOS Keychain
+4. Tap **Connect to Nightscout** to validate the connection
 
-[For help making a Nightscout account, please see the OpenAPS documentation.](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/nightscout-setup.html)
+![Connect Nightscout](img/connect-nightscout.png)
 
-## Trio Setup
+</div>
 
-To enable your *Nightscout* connection:
+Trio will test the connection by uploading a test treatment. If successful, your Nightscout configuration is saved.
 
-- input your ***Nightscout* URL**, including the `https://` and your **`API_SECRET`**. 
-- Toggle on **`Allow Uploading to Nightscout`** so *Trio* can share its predictions and settings with *Nightscout*. 
-
-!!! important "A Nightscout URL starts with httpS://"
+!!! important "A Nightscout URL starts with https://"
 
-     Your *Nightscout* URL must start with `https://`.  
-     To set this up correctly, do not forget the letter `s` between `http` and `://`.
+    - Your *Nightscout* URL must start with `https://`.  
+    - To set this up correctly, do not forget the letter `s` between `http` and `://`.
+
+### Step 2: Utilize Upload/Download
+
+<div class="grid" markdown>
+
+- **Upload**:
+    - Enable **Allow Uploading to Nightscout** toggle
+        - Optionally enable **Upload Glucose** if you want CGM data uploaded from Trio rather than from your CGM
+        - Trio immediately uploads your current profile when enabled
+    - [What Trio Uploads to Nightscout](../../../usage/ecosystem/nightscout-app.md#what-trio-uploads-to-nightscout)
+
+![Upload](img/upload.png#only-light){width="250"}
+![Upload](img/upload-dark.png#only-dark){width="250"}
+
+- **Download**:
+    - Enable **Allow Fetching from Nightscout** toggle
+        - Trio will download carbs, temp targets, and optionally glucose from Nightscout
+        - Used as backup or when using Nightscout as primary CGM source
+    - [What Trio Downloads from Nightscout](../../../usage/ecosystem/nightscout-app.md#what-trio-downloads-from-nightscout)
+
+![Fetch](img/fetch.png#only-light){width="250"}
+![Fetch](img/fetch-dark.png#only-dark){width="250"}
+
+- **Backfill Glucose**:
+    - Tap **Backfill Glucose**
+        - Trio will fetch any missed glucose readings from the last 24 hours
+
+![Backfill](img/backfill.png#only-light){width="250"}
+![Backfill](img/backfill-dark.png#only-dark){width="250"}
+
+</div>
+
+## Nightscout Integration
+
+Read more about the integration of Nightscout in Trio [here](../../../usage/ecosystem/nightscout-app.md)

docs/help/faq.md

@@ -219,7 +219,7 @@ The following CGM can be used with Trio:
 ###What CGM apps can be used with Trio?
 
 **xDrip**  
-To use xDrip4iOS as a CGM source, you must build it yourself with the same Apple Developer account you used to build your Trio app. Please see the following for instructions on how to build xDrip4iOS yourself [here](../install/ecosystem/xdrip4ios.md).  
+To use xDrip4iOS as a CGM source, you must build it yourself with the same Apple Developer account you used to build your Trio app. Please see the following for instructions on how to build xDrip4iOS yourself [here](../usage/ecosystem/xdrip4ios.md).  
 
 !!! tip
     _If you use xDrip with the Dexcom G6/ONE, in Trio select 'Dexcom G6' as the CGM source. Trio will intercept glucose readings directly from the transmitter._

docs/help/glossary.md

@@ -87,6 +87,8 @@ When Google Translate is selected:
 
 **<span translate="no">Omnipod</span>**&nbsp; (Omnipod): Insulet tubeless insulin pump
 
+**<span translate="no">OS-AID</span>**&nbsp; (OS-AID): Open-Source Automated Insulin Delivery System
+
 **<span translate="no">PR</span>**&nbsp; (PR): Pull Request - a formal method to request changes to a repository
 
 **<span translate="no">Provisioning Profile</span>**&nbsp; (Provisioning Profile): associates your app with your Developer ID and limits app lifetime to 1 year (paid) or 1 week (free)

docs/help/index.md

@@ -20,11 +20,10 @@ Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome
 
     🚧 Documentation Under Construction 🚧
 
--   __[Glossary](glossary.md) ✏️__
+-   __[Glossary](glossary.md)__
 
     - - -
-
-    🚧 Documentation Under Construction 🚧  
+
     A compilation of Trio terms and definitions
 
 -   __[Troubleshooting](troubleshoot.md) ✏️__

docs/index.md

@@ -1,7 +1,7 @@
 !!! 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.
+    Please read the [Migration Guide](usage/migration/trio-02x-migration.md) before updating.
 
 !!! important "🚧 Documentation Under Construction 🚧"