Skip to content

Commit bc1734f

Browse files
marionbarkermarionbarker
authored
Merge pull request #37 from loopandlearn/add-quick-pick-docs
Document Quick-Pick Boluses and Meals for remote commands
2 parents b892654 + 04bee81 commit bc1734f

4 files changed

Lines changed: 93 additions & 0 deletions

File tree

‎docs/remote/img/lf-quick-pick-bolus.png‎

25.3 KB
Loading

‎docs/remote/img/lf-quick-pick-meal.png‎

33.8 KB
Loading

‎docs/remote/remote-control-loop.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,51 @@ Example messages are highlighted by red rectangles in the composite below for re
8282
If the last update was more than 12 minutes ago, that line is not prefilled.
8383

8484

85+
### Quick-Pick Boluses and Meals
86+
87+
!!! info "Available in *LoopFollow* 6.2 and newer"
88+
<!-- TODO: confirm the exact release version before publishing -->
89+
90+
To save a step when sending a remote command, *LoopFollow* shows **Quick-Pick**
91+
buttons at the top of the Bolus and Carbs screens. Each button fills in the
92+
amounts from one of your recent entries with a single tap.
93+
94+
* **Quick-Pick Boluses** appear on the Bolus screen and fill in an insulin amount.
95+
* **Quick-Pick Meals** appear on the Carbs screen and fill in **carbs only**,
96+
since *Loop* remote carb entries do not include fat or protein.
97+
98+
| Quick-Pick Boluses | Quick-Pick Meals |
99+
|:--:|:--:|
100+
| ![Quick-Pick Boluses on the remote Bolus screen](img/lf-quick-pick-bolus.png){width="300"} | ![Quick-Pick Meals on the remote Carbs screen](img/lf-quick-pick-meal.png){width="300"} |
101+
{align="center"}
102+
103+
Tapping a button only **fills in** the fields — nothing is sent until you review
104+
the values and tap **Send Bolus** / **Send Meal**, exactly as with a manual entry.
105+
Guardrails still apply.
106+
107+
#### How the suggestions are chosen
108+
109+
Every bolus or carb entry you successfully send is stored **locally on your
110+
phone**. When you open a remote screen, that history is scored to surface the
111+
most relevant options for the current moment, considering:
112+
113+
* **Time of day** — entries sent around this time of day score higher
114+
* **Day of week** — weekday and weekend patterns are kept separate
115+
* **Recency** — older entries gradually fade out
116+
117+
Up to five buttons are shown, and the Quick-Pick section is hidden entirely
118+
until you have history to draw from. So if you usually send the same breakfast
119+
on weekday mornings, that entry tends to appear as an option on weekday mornings.
120+
121+
!!! note
122+
The history is private to the device and stored in *LoopFollow* only.
123+
*Nightscout* cannot tell remote entries apart from manual ones, so it is not
124+
used as a source — a freshly installed or reset phone starts with no
125+
Quick-Pick suggestions until you send a few commands.
126+
127+
Tap the :material-information-outline: info icon next to **Quick-Pick Boluses**
128+
or **Quick-Pick Meals** in the app for a short in-screen explanation.
129+
85130
### Overrides
86131

87132
***More info coming soon!***

‎docs/remote/remote-control-trio.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,54 @@ When entering meals and choosing to schedule the meal, any bolus included in the
9898

9999
***More info coming soon!***
100100

101+
### Quick-Pick Boluses and Meals
102+
103+
!!! info "Available in *LoopFollow* 6.2 and newer"
104+
<!-- TODO: confirm the exact release version before publishing -->
105+
106+
To save a step when sending a remote command, *LoopFollow* shows **Quick-Pick**
107+
buttons at the top of the Bolus and Meal screens. Each button fills in the
108+
amounts from one of your recent entries with a single tap.
109+
110+
* **Quick-Pick Boluses** appear on the Bolus screen and fill in an insulin amount.
111+
* **Quick-Pick Meals** appear on the Meal screen and fill in carbs, and — when
112+
enabled in [Meal Settings](#meal-settings) — fat, protein, and the meal bolus.
113+
114+
| Quick-Pick Boluses | Quick-Pick Meals |
115+
|:--:|:--:|
116+
| ![Quick-Pick Boluses on the remote Bolus screen](img/lf-quick-pick-bolus.png){width="300"} | ![Quick-Pick Meals on the remote Meal screen](img/lf-quick-pick-meal.png){width="300"} |
117+
{align="center"}
118+
119+
Tapping a button only **fills in** the fields — nothing is sent until you review
120+
the values and tap **Send Bolus** / **Send Meal**, exactly as with a manual entry.
121+
Guardrails still apply.
122+
123+
#### How the suggestions are chosen
124+
125+
Every bolus or meal you successfully send is stored **locally on your phone**.
126+
When you open a remote screen, that history is scored to surface the most
127+
relevant options for the current moment, considering:
128+
129+
* **Time of day** — entries sent around this time of day score higher
130+
* **Day of week** — weekday and weekend patterns are kept separate
131+
* **Recency** — older entries gradually fade out
132+
133+
Up to five buttons are shown, and the Quick-Pick section is hidden entirely
134+
until you have history to draw from. So if you usually send the same breakfast
135+
on weekday mornings, that entry tends to appear as an option on weekday mornings.
136+
137+
A bolus that was part of a meal is stored with that meal, so it does **not**
138+
appear among your standalone Quick-Pick Boluses.
139+
140+
!!! note
141+
The history is private to the device and stored in *LoopFollow* only.
142+
*Nightscout* cannot tell remote entries apart from manual ones, so it is not
143+
used as a source — a freshly installed or reset phone starts with no
144+
Quick-Pick suggestions until you send a few commands.
145+
146+
Tap the :material-information-outline: info icon next to **Quick-Pick Boluses**
147+
or **Quick-Pick Meals** in the app for a short in-screen explanation.
148+
101149
### Temp Target
102150

103151
***More info coming soon!***

0 commit comments

Comments
 (0)