Update Companion App Documentation and Update Core Concepts Testing

docs/configuration/migration/aaps-migration.md

@@ -71,7 +71,7 @@ A full day on Trio! Congratulations! Here's what to look for:
     - [Carb Ratio Testing](../../usage/concepts/carb-ratios.md)
 
 - **Review Dynamic ISF Documentation**  
-    Review the documentation on [Using Dynamic ISF](../../usage/features/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
+    Review the documentation on [Using Dynamic ISF](../../usage/explained/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
 
 - - -
 
@@ -82,7 +82,7 @@ You've completed a week on Trio! Here's what you should see:
 - **Dynamic ISF**  
     - Dynamic ISF now has enough data. You now have the option to enable it.
     - The Logarithmic formula in Trio is the most similar to AAPS dynamic ISF. The Sigmoid formula behaves very differently (informative links below). Which one you use is up to you.
-    - This is a great time to refresh [Using Dynamic ISF](../../usage/features/dynamic-isf.md) and check your settings for [Logarithmic Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-logarithmic) or [Sigmoid Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-sigmoid).
+    - This is a great time to refresh [Using Dynamic ISF](../../usage/explained/dynamic-isf.md) and check your settings for [Logarithmic Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-logarithmic) or [Sigmoid Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-sigmoid).
 
 !!! warning "Can't Enable Dynamic ISF?"
     If Dynamic ISF does not give you the option to enable, you may have experienced one or more of the following:

docs/configuration/migration/iaps-migration.md

@@ -70,7 +70,7 @@ A full day on Trio! Congratulations! Here's what to look for:
     - [Carb Ratio Testing](../../usage/concepts/carb-ratios.md)
 
 - **Review Dynamic ISF Documentation**  
-    Review the documentation on [Using Dynamic ISF](../../usage/features/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
+    Review the documentation on [Using Dynamic ISF](../../usage/explained/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
 
 - - -
 
@@ -81,7 +81,7 @@ You've completed a week on Trio! Here's what you should see:
 - **Dynamic ISF**  
     Dynamic ISF now has enough data. You now have the option to enable it.
 
-    This is a great time to refresh [Using Dynamic ISF](../../usage/features/dynamic-isf.md)and check your settings for [Logarithmic Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-logarithmic) or [Sigmoid Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-sigmoid).
+    This is a great time to refresh [Using Dynamic ISF](../../usage/explained/dynamic-isf.md)and check your settings for [Logarithmic Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-logarithmic) or [Sigmoid Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-sigmoid).
 
     !!! warning "Can't Enable Dynamic ISF?"
         If Dynamic ISF does not give you the option to enable, you may have experienced one or more of the following:

docs/configuration/migration/loop-migration.md

@@ -73,7 +73,7 @@ A full day on Trio! Congratulations! Here's what to look for:
     - [Carb Ratio Testing](../../usage/concepts/carb-ratios.md)
 
 - **Review Dynamic ISF Documentation**  
-    Review the documentation on [Using Dynamic ISF](../../usage/features/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
+    Review the documentation on [Using Dynamic ISF](../../usage/explained/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
 - **Meal Time Struggles**  
     Sometimes, users coming from Loop will notice stability during fasting periods, but meal times are more challenging than they were with Loop. This is due to a shift in algorithms. Loop is more carb-centric, causing users to place a heavy reliance upon their Carb Ratio over their ISF value. Trio is more reliant upon your ISF value and as such you may find you need to adjust your ISF and possibly your CR when you switch from Loop to Trio. 
 - - -
@@ -85,7 +85,7 @@ You've completed a week on Trio! Here's what you should see:
 - **Dynamic ISF**  
     Dynamic ISF now has enough data. You now have the option to enable it.
 
-    This is a great time to refresh [Using Dynamic ISF](../../usage/features/dynamic-isf.md)and check your settings for [Logarithmic Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-logarithmic) or [Sigmoid Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-sigmoid).
+    This is a great time to refresh [Using Dynamic ISF](../../usage/explained/dynamic-isf.md)and check your settings for [Logarithmic Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-logarithmic) or [Sigmoid Dynamic ISF](../settings/algorithm/dynamic-settings.md#dynamic-isf-sigmoid).
 
     !!! warning "Can't Enable Dynamic ISF?"
         If Dynamic ISF does not give you the option to enable, you may have experienced one or more of the following:

docs/configuration/migration/trio-02x-migration.md

@@ -21,7 +21,7 @@
 - **Rewritten Backend & Data Storage**  
     Entire app logic and data storage rewritten for speed, stability, and future flexibility.
 - **Remote Commands & iOS Shortcuts**  
-    Trigger actions like carb entry, bolus, overrides or temporary targets [remotely](../settings/features/remote-control.md) or through [shortcut automation](../settings/features/shortcuts.md).
+    Trigger actions like carb entry, bolus, overrides or temporary targets [remotely](../settings/features/remote-control.md) using LoopFollow or through [shortcut automation](../settings/features/shortcuts.md).
 - **Smarter Settings**  
     Helpful hints, guidance sheets, and a built-in search function — just like iOS Settings. Information on the updated Trio Settings can be found [here](../settings/index.md).
 - **New Bolus Calculator**  
@@ -73,6 +73,10 @@ Here are some things to keep in mind after upgrading from Trio 0.2 to Trio 0.5 (
     This is a great time to test your settings so you can start fresh on solid footing.
 - **New User Interface**  
     Use this time to learn the [New User Interface](../../usage/interface.md).
+- **Remote Control**  
+    - In Trio 0.2.x, *Nightscout* Careportal could be used to enter `Carb Correction`, and start and cancel `Temporary Target`. *This continues to be an option in Trio 0.5.x (or newer)*
+    - Trio 0.2.x also supported other remote options (using announcements via Careportal). Those options were replaced by the more secure [**LoopFollow - Trio Remote Control**](../../install/ecosystem/loop-follow.md) for Trio 0.5.x (or newer)
+    - **Using announcements to provide remote control of the Trio phone is no longer supported**
 
 !!! danger "Do not use a pump or cgm simulator"
     - Doing so will result in false data being stored and you will have to delete the app with all the data and reinstall before you can use it on a live pump.
@@ -95,7 +99,7 @@ A full day on Trio 0.5 (or higher)! Congratulations! Here's what to look for:
     - [Carb Ratio Testing](../../usage/concepts/carb-ratios.md)
 
 - **Review Dynamic ISF Documentation**  
-    Review the documentation on [Using Dynamic ISF](../../usage/features/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
+    Review the documentation on [Using Dynamic ISF](../../usage/explained/dynamic-isf.md) in preparation for [Day 7](#what-to-expect-after-7-days).
 
 - - -
 

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/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/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*](../../../install/ecosystem/loop-follow.md) or from [*Nightscout*](../../../install/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
 

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

@@ -6,25 +6,22 @@ Please use the navigation menu :fontawesome-solid-bars:, search bar :fontawesome
 
 <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](../../../install/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](../../../install/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](../../../install/ecosystem/nightscout-app.md)

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) ✏️__