Skip to content

Commit 83f9b8f

Browse files
author
Claude Assistant
committed
Add closed-loop testing guidance and missing glossary terms
Adds 'Important Info For Testing Settings in Trio' callouts to the three Core Concepts testing sections (Basal Rates, ISF, Carb Ratios), recommending Max IOB = 0 and Autosens Min/Max = 100% while testing in closed loop, plus a reminder to test basal rates before ISF/CR. Adds 4 missing glossary terms: IAGE, OS-AID, SAGE, TDD. Deliberately surgical, not a wholesale file replacement: dev has independently evolved basal-rates.md and isf.md since #207 branched (different 'Fasting is Essential' callout text, an updated pump compatibility table including Medtrum Nano). Only the clearly new, non-conflicting testing-guidance paragraphs were ported over; the parts where dev's content differs from the PR were left untouched rather than guessed at. Not included from the original cleanup commits (a40de8f, db14841, 62bc3f0, 662df68, 00d14f1, e2569ba, 97bc3fa, 3b2a3f3, dec2361): - Fixes to usage/ecosystem/*.md content are already baked into PR1 (that PR took the final state of those files directly) - 'Return App Diagnostics to index and mkdocs.yml' (a52784d): already present independently in current dev, nothing to port - README.md revert: only a trailing-whitespace difference in current dev, not worth a change - help/index.md changes (Discord/Facebook links, FAQ 'under construction' marker): unrelated to this commit's stated purpose and dev has diverged here too -- left alone rather than guessed at Extracted from #207 (tmhastings), commit 7890536.
1 parent a3ff9bf commit 83f9b8f

4 files changed

Lines changed: 43 additions & 0 deletions

File tree

docs/usage/concepts/basal-rates.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,16 @@ The allowed basal rate range depends on your insulin pump:
8989

9090
Accurate basal rates are essential for Trio to function optimally. Here are two methods to verify and adjust your basal rates:
9191

92+
!!!important "Important Info For Testing Settings in Trio"
93+
When testing your settings in Trio, it's recommended to do so in **CLOSED LOOP** with the following settings adjustments:
94+
95+
- **Maximum IOB**: set to 0
96+
- **Autosens Max**: set to 100%
97+
- **Autosens Min**: set to 100%
98+
99+
This will allow Trio to prevent lows, but will not allow Trio to correct highs or give more than your current scheduled basal rate. Using this method will mean that at most only your scheduled basal rate is given while you are testing basals. No automated corrections will interfere with your basal test.
100+
101+
92102
### 1. Fasting Tests
93103

94104
The traditional method for testing basal rates:

docs/usage/concepts/carb-ratios.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,20 @@ The available values range from 1.0 to 50.0 in 0.1 increments, giving you fine-g
108108

109109
## Testing and Adjusting Your CR
110110

111+
!!!note "Before You Test CR"
112+
Did you already [confirm/test your basal rates](basal-rates.md#testing-your-basal-rates)? If basal rates are not accurate, your CR test will also not be accurate.
113+
***Always test basals first***.
114+
115+
!!!important "Important Info For Testing Settings in Trio"
116+
When testing your settings in Trio, it's recommended to do so in **CLOSED LOOP** with the following settings adjustments:
117+
118+
- **Maximum IOB**: set to 0
119+
- **Autosens Max**: set to 100%
120+
- **Autosens Min**: set to 100%
121+
122+
This will allow Trio to prevent lows, but will not allow Trio to correct highs or give more than your current scheduled basal rate. Using this method will result in only your carb ratio being used for your test as there will be no additional insulin given by Trio.
123+
124+
111125
### Starting Point
112126

113127
If you're coming from pump therapy, you can transfer your pump's CR as a starting point. However, verify its accuracy through testing, especially if you experience:

docs/usage/concepts/isf.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -148,6 +148,21 @@ Your insulin sensitivity varies throughout the day due to hormones, activity, an
148148

149149
## Testing and Adjusting Your ISF
150150

151+
!!!note "Before You Test ISF"
152+
Did you already [confirm/test your basal rates](basal-rates.md#testing-your-basal-rates)? If basal rates are not accurate, your ISF test will also not be accurate.
153+
***Always test basals first***.
154+
155+
156+
!!!important "Important Info For Testing Settings in Trio"
157+
When testing your settings in Trio, it's recommended to do so in **CLOSED LOOP** with the following settings adjustments:
158+
159+
- **Maximum IOB**: set to 0
160+
- **Autosens Max**: set to 100%
161+
- **Autosens Min**: set to 100%
162+
163+
This will allow Trio to prevent lows, but will not allow Trio to correct highs or give more than your current scheduled basal rate. Using this method will result in the correction dose you initiate for your ISF test will be the only correction given. Trio will not increase that even if your glucose rises or does not fall.
164+
165+
151166
### Starting Point
152167

153168
If you're coming from pump therapy, you can transfer your pump's ISF as a starting point. However, be prepared to adjust it based on Trio's behavior.

includes/glossary.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@
2222
*[GMT]: Greenwich Mean Time is mean (average) solar time at 0 degrees longitude, see UTC
2323
*[Guardrails]: limits in the code for user selected settings, recommended and absolute limits are provided
2424
*[Hamburger Menu]: three parallel lines that, when tapped, open a new menu
25+
*[IAGE]: insulin age (time since insulin reservoir was last changed) on Nightscout site
2526
*[Identifiers]: names of modules found on your Apple Developer Identifiers page that are required for GitHub build method
2627
*[IOB]: Insulin on Board, affects automated insulin delivery: the current active insulin (above or below the basal rate)
2728
*[iOS]: operating system used by Apple Mobile devices (iPhone, iPod, iPad)
@@ -37,17 +38,20 @@
3738
*[NFC]: Near-Field Communication is used for scanning devices such as Libre sensors
3839
*[Nightscout]: a personal website used to view your glucose and diabetes management data.
3940
*[Omnipod]: Insulet tubeless insulin pump
41+
*[OS-AID]: Open-Source Automated Insulin Delivery System (Trio, Loop, AAPS, OpenAPS)
4042
*[PR]: Pull Request - a formal method to request changes to a repository
4143
*[Provisioning Profile]: associates your app with your Developer ID and limits app lifetime to 1 year (paid) or 1 week (free)
4244
*[Pull Request]: formal method to request changes to a repository
4345
*[QR]: a machine-readable code consisting of an array of black and white squares
4446
*[repository]: contains project files and each file's revision history
47+
*[TDD]: total daily dose — cumulative amount of insulin (bolus and basal) delivered over a 24-hour period
4548
*[TEAMID]: One of 6 Secrets: Apple Developer account member number
4649
*[FASTLANE_ISSUER_ID]: One of 6 Secrets: the issuer ID is associated with your Apple Developer ID and never changes
4750
*[FASTLANE_KEY_ID]: One of 6 Secrets: Key ID provided when you create an API key in App Store Connect; it is associated with the FASTLANE_KEY
4851
*[FASTLANE_KEY]: One of 6 Secrets: Really long key (several lines); it and FASTLANE_KEY_ID are generated together
4952
*[GH_PAT]: One of 6 Secrets: Generated with your GitHub account; set it to never expire
5053
*[MATCH_PASSWORD]: 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.
54+
*[SAGE]: sensor age of CGM on Nightscout site
5155
*[SHA-1]: Secure Hash Algorithm 1; used to generate an alphanumeric code for commits in git (github)
5256
*[Terminal]: interface for entering commands to the computer
5357
*[TestFlight]: a method to distribute apps without direct connection

0 commit comments

Comments
 (0)