diff --git a/docs/EN/changelanguage.md b/docs/EN/ChangeLanguage/ChangeLanguage.md
similarity index 66%
rename from docs/EN/changelanguage.md
rename to docs/EN/ChangeLanguage/ChangeLanguage.md
index bdd3a34dd476..72f55716b9ca 100644
--- a/docs/EN/changelanguage.md
+++ b/docs/EN/ChangeLanguage/ChangeLanguage.md
@@ -4,4 +4,4 @@
The language selection have been moved to the bottom drawer of the left menu. Please click on the bottom bar to open language selection menu.
```
-{w=350px align=center}
+{w=350px align=center}
diff --git a/docs/EN/Children/Children.md b/docs/EN/Children/Children.md
index f78d5690c32e..e8d0f5a840a2 100644
--- a/docs/EN/Children/Children.md
+++ b/docs/EN/Children/Children.md
@@ -10,14 +10,14 @@ AAPS offer several options for remote monitoring of children and also allows to
- Parents can remotely follow seeing all relevant data such as glucose levels, carbs on board, insulin on board etc. using **AAPSClient app** on their phone. Settings must be the same in AAPS and AAPSClient app.
- Parents can be alarmed by using **xDrip+ app in follower mode** on their phone.
- Remote control of AAPS using [SMS Commands](../Children/SMS-Commands.md) secured by two-factor authentication.
-- Remote control through AAPSClient app is only recommended if your synchronization is working well (ie. you don’t see unwanted data changes like self modification of TT, TBR etc) see [release notes for Version 2.8.1.1](Releasenotes-important-hints-2-8-1-1) for further details.
+- Remote control through AAPSClient app is only recommended if your synchronization is working well (ie. you don’t see unwanted data changes like self modification of TT, TBR etc) see [release notes for Version 2.8.1.1](../Installing-AndroidAPS/Releasenotes.md#version-2.8.1.1) for further details.
## Tools and apps for remote monitoring
- [Nightscout](https://nightscout.github.io/) in web browser (mainly data display)
- AAPSClient app is a stripped down version of AAPS capable of following somebody, making profile switches, setting TTs and entering carbs. There are 2 apps: [AAPSClient & AAPSClient2 to download](https://github.com/nightscout/AndroidAPS/releases/). The only difference is the app name. This way you can install the app twice on the same phone, to be able to follow 2 different persons/nightscouts with it.
- Dexcom follow if you are using original Dexcom app (BG values only)
-- [xDrip+](../Configuration/xdrip.md) in follower mode (mainly BG values and **alarms**)
+- [xDrip+](../CompatibleCgms/xDrip.md) in follower mode (mainly BG values and **alarms**)
- [Sugarmate](https://sugarmate.io/) or [Spike](https://spike-app.com/) on iOS (mainly BG values and **alarms**)
- Some users find a full remote access tool like [TeamViewer](https://www.teamviewer.com/) to be helpful for advanced remote troubleshooting
@@ -30,7 +30,7 @@ A smartwatch can be a very useful tool in helping manage AAPS with kids. A coupl
## Things to consider
-- Setting the correct [treatment factors](FAQ-how-to-begin) (basal rate, DIA, ISF...) is difficult for kids, especially when growth hormones are involved.
+- Setting the correct [treatment factors](../Getting-Started/FAQ.md#how-to-begin) (basal rate, DIA, ISF...) is difficult for kids, especially when growth hormones are involved.
- Settings must be the same in AAPS and AAPSClient app.
- Consider time gap between master and follower due to time for up- and download as well as the fact that AAPS master phone will only upload after loop run.
- So take your time to set those correctly and test them in real life with your kid next to you before starting remote monitoring and remote treatment. School holidays might be a good time for that.
diff --git a/docs/EN/Hardware/CgmNightscoutUpload.md b/docs/EN/CompatibleCgms/CgmNightscoutUpload.md
similarity index 79%
rename from docs/EN/Hardware/CgmNightscoutUpload.md
rename to docs/EN/CompatibleCgms/CgmNightscoutUpload.md
index dc03343e4d65..af5d9a1f4a54 100644
--- a/docs/EN/Hardware/CgmNightscoutUpload.md
+++ b/docs/EN/CompatibleCgms/CgmNightscoutUpload.md
@@ -7,4 +7,4 @@ This data source will not work when you are offline, when you experience network
```
- Setup NSClient with your Nightscout site information.
-- Select NSClient BG in [ConfigBuilder, BG Source](/Configuration/Config-Builder.md#bg-source).
+- Select NSClient BG in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
diff --git a/docs/EN/Hardware/DexcomG5.md b/docs/EN/CompatibleCgms/DexcomG5.md
similarity index 94%
rename from docs/EN/Hardware/DexcomG5.md
rename to docs/EN/CompatibleCgms/DexcomG5.md
index bdb4cdec1442..3523ae6524fc 100644
--- a/docs/EN/Hardware/DexcomG5.md
+++ b/docs/EN/CompatibleCgms/DexcomG5.md
@@ -4,7 +4,7 @@
- You can safely download the [latest APK (stable)](https://xdrip-plus-updates.appspot.com/stable/xdrip-plus-latest.apk) unless you want specific newly developed features.
- Setup xDrip+ with G5 following [these instructions](https://navid200.github.io/xDrip/docs/G5-Recommended-Settings.html).
-- Setup xDrip+ reading the [xDrip+ settings page](../Configuration/xdrip.md) .
+- Setup xDrip+ reading the [xDrip+ settings page](../CompatibleCgms/xDrip.md) .
- Select xDrip+ in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
## If using G5 with patched Dexcom app
diff --git a/docs/EN/Hardware/DexcomG6.md b/docs/EN/CompatibleCgms/DexcomG6.md
similarity index 92%
rename from docs/EN/Hardware/DexcomG6.md
rename to docs/EN/CompatibleCgms/DexcomG6.md
index 911b98a9dce8..aa41e0e14237 100644
--- a/docs/EN/Hardware/DexcomG6.md
+++ b/docs/EN/CompatibleCgms/DexcomG6.md
@@ -2,7 +2,7 @@
## Basics first
-- Follow general CGM hygiene and setting sensor recommendation [here](../Hardware/GeneralCGMRecommendation.md).
+- Follow general CGM hygiene and setting sensor recommendation [here](../CompatibleCgms/GeneralCGMRecommendation.md).
## General hints for looping with G6 and ONE
@@ -21,12 +21,12 @@ Read more in the [article](https://www.diabettech.com/artificial-pancreas/diy-lo
- If you are using an old rebatteried transmitter, the safest thing to do is **disable** [preemptive restarts](https://navid200.github.io/xDrip/docs/Preemptive-Restart.html). Though, in this case you will have to use the G6 in non-[native mode](https://navid200.github.io/xDrip/docs/Native-Algorithm.html) (which is unadvisable as it disables factory calibration and doesn't filter noisy readings), or else the sensor will stop after 10 days.
- The Dexcom G6 and ONE transmitters can simultaneously be connected to the Dexcom receiver (or alternatively the t:slim pump) and one app on your phone.
- When using xDrip+ as receiver uninstall the Dexcom app first. **You cannot connect xDrip+ and Dexcom app with the transmitter at the same time!**
-- If you need Clarity and want to profit from xDrip+ alarms use the [BYODA](DexcomG6-if-using-g6-with-build-your-own-dexcom-app) (only G6) with local broadcast to xDrip+.
+- If you need Clarity and want to profit from xDrip+ alarms use the [BYODA](#if-using-g6-with-build-your-own-dexcom-app) (only G6) with local broadcast to xDrip+.
- You can also use xDrip+ as a companion app of the official Dexcom app, but you might experience delays in BG readings.
-- If not already set up, download [xDrip+](https://github.com/NightscoutFoundation/xDrip) and follow the instructions on [xDrip+ settings page](../Configuration/xdrip.md).
+- If not already set up, download [xDrip+](https://github.com/NightscoutFoundation/xDrip) and follow the instructions on [xDrip+ settings page](../CompatibleCgms/xDrip.md).
- Select xDrip+ in in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
-- Adjust settings in xDrip+ according to [xDrip+ settings page](../Configuration/xdrip.md)
+- Adjust settings in xDrip+ according to [xDrip+ settings page](../CompatibleCgms/xDrip.md)
(DexcomG6-if-using-g6-with-build-your-own-dexcom-app)=
## If using G6 with Build Your Own Dexcom App
@@ -65,7 +65,7 @@ Read more in the [article](https://www.diabettech.com/artificial-pancreas/diy-lo
### General troubleshooting
-General Troubleshooting for CGMs can be found [here](./GeneralCGMRecommendation.md#troubleshooting).
+General Troubleshooting for CGMs can be found [here](../CompatibleCgms/GeneralCGMRecommendation.md#troubleshooting).
### New transmitter with running sensor
diff --git a/docs/EN/Hardware/DexcomG7.md b/docs/EN/CompatibleCgms/DexcomG7.md
similarity index 88%
rename from docs/EN/Hardware/DexcomG7.md
rename to docs/EN/CompatibleCgms/DexcomG7.md
index 36ba5758c512..65ae57859efa 100644
--- a/docs/EN/Hardware/DexcomG7.md
+++ b/docs/EN/CompatibleCgms/DexcomG7.md
@@ -7,7 +7,7 @@ Noteworthy is the fact that the G7 and ONE+ systems, compared to the G6, do not
-```{admonition} [Smoothing method](../Usage/Smoothing-Blood-Glucose-Data)
+```{admonition} [Smoothing method](../CompatibleCgms/SmoothingBloodGlucoseData.md)
:class: warning
**Exponential Smoothing** **MUST** be enabled for meaningful use of the G7 / ONE+ values.
```
@@ -26,11 +26,10 @@ A patched Dexcom G7 app (DiaKEM) gives access to the Dexcom G7 data. This is not
- Enter sensor code in the patched app.
-- Follow the general recommendations for CGM hygiene and sensor placement found [here](../Hardware/GeneralCGMRecommendation.md).
+- Follow the general recommendations for CGM hygiene and sensor placement found [here](../CompatibleCgms/GeneralCGMRecommendation.md).
- After the warm-up phase, the values are displayed as usual in the G7 app.
-
### Configuration in AAPS
- Select 'BYODA' in in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source) - even if it is not the BYODA app!
@@ -42,7 +41,7 @@ A patched Dexcom G7 app (DiaKEM) gives access to the Dexcom G7 data. This is not
- Follow the instructions here: [Xdrip+ G7](https://navid200.github.io/xDrip/docs/Dexcom/G7.html)
- Select xDrip+ in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
-- Adjust the xDrip+ settings according to the explanations on the xDrip+ settings page [xDrip+ settings](../Configuration/xdrip.md)
+- Adjust the xDrip+ settings according to the explanations on the xDrip+ settings page [xDrip+ settings](../CompatibleCgms/xDrip.md)
## 3. xDrip+ (companion mode)
@@ -50,4 +49,4 @@ A patched Dexcom G7 app (DiaKEM) gives access to the Dexcom G7 data. This is not
- As data source in xDrip+ "Companion App" must be selected and under Advanced Settings > Bluetooth Settings > "Companion Bluetooth" must be enabled.
- Select xDrip+ in in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
-- Adjust the xDrip+ settings according to the explanations on the xDrip+ settings page [xDrip+ settings](../Configuration/xdrip.md)
+- Adjust the xDrip+ settings according to the explanations on the xDrip+ settings page [xDrip+ settings](../CompatibleCgms/xDrip.md)
diff --git a/docs/EN/Hardware/Eversense.md b/docs/EN/CompatibleCgms/Eversense.md
similarity index 93%
rename from docs/EN/Hardware/Eversense.md
rename to docs/EN/CompatibleCgms/Eversense.md
index a3e1fe232071..45a6b79d567c 100644
--- a/docs/EN/Hardware/Eversense.md
+++ b/docs/EN/CompatibleCgms/Eversense.md
@@ -58,8 +58,8 @@ xDrip+ can read notifications from the vendor app, like ESEL does. No backfillin
- Download and install xDrip+: [xDrip](https://github.com/NightscoutFoundation/xDrip)
- As data source in xDrip+ “Companion App” must be selected.
- Select xDrip+ in in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
-- Adjust the xDrip+ settings according to the explanations on the xDrip+ settings page [xDrip+ settings](../Configuration/xdrip.md).
-- Enable [Exponential Smoothing](../Usage/Smoothing-Blood-Glucose-Data.md#smoothing-blood-glucose-data) in AAPS.
+- Adjust the xDrip+ settings according to the explanations on the xDrip+ settings page [xDrip+ settings](../CompatibleCgms/xDrip.md).
+- Enable [Exponential Smoothing](../CompatibleCgms/SmoothingBloodGlucoseData.md#smoothing-blood-glucose-data) in AAPS.
```{warning}
BG values reading frequency is not always 5 minutes and duplicates can occur.
diff --git a/docs/EN/Hardware/GeneralCGMRecommendation.md b/docs/EN/CompatibleCgms/GeneralCGMRecommendation.md
similarity index 96%
rename from docs/EN/Hardware/GeneralCGMRecommendation.md
rename to docs/EN/CompatibleCgms/GeneralCGMRecommendation.md
index 21ec5e9122b6..b5a032317e40 100644
--- a/docs/EN/Hardware/GeneralCGMRecommendation.md
+++ b/docs/EN/CompatibleCgms/GeneralCGMRecommendation.md
@@ -29,7 +29,6 @@ After setting the sensor, the transmitter can be clicked into the sensor
holder. Caution! First click in the square side and then press down the
round side.
-(GeneralCGMRecommendation-troubleshooting)=
## Troubleshooting
### Connection problems
@@ -61,6 +60,6 @@ data](../Usage/Smoothing-Blood-Glucose-Data-in-xDrip.md).
This occurs if there is either a double "CGM Sensor Insert" entry in
-[actions tab / menu](Config-Builder-actions) or a
+[actions tab / menu](../Getting-Started/Screenshots.md#action-tab) or a
sensor insert with wrong date. Go to treatments tab \> careportal and
delete the wrong entry.
diff --git a/docs/EN/Hardware/Libre1.md b/docs/EN/CompatibleCgms/Libre1.md
similarity index 97%
rename from docs/EN/Hardware/Libre1.md
rename to docs/EN/CompatibleCgms/Libre1.md
index 5d3aca2d4a1a..40efff4e32ae 100644
--- a/docs/EN/Hardware/Libre1.md
+++ b/docs/EN/CompatibleCgms/Libre1.md
@@ -35,7 +35,7 @@ details.
- xDrip+ supports Miaomiao, Bubble, Blucon, Atom and LibreAlarm.
- You can safely download the [latest APK (stable)](https://xdrip-plus-updates.appspot.com/stable/xdrip-plus-latest.apk) unless you need recent features, in which case you should use the latest [Nightly Snapshot](https://github.com/NightscoutFoundation/xDrip/releases).
-- Follow setup instructions on [xDrip+ settings page](../Configuration/xdrip.md).
+- Follow setup instructions on [xDrip+ settings page](../CompatibleCgms/xDrip.md).
- You also need [OOP2](https://drive.google.com/file/d/1f1VHW2I8w7Xe3kSQqdaY3kihPLs47ILS/view) for Libre 1 US (and Libre 2 EU).
- Select xDrip+ in in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
diff --git a/docs/EN/Hardware/Libre2.md b/docs/EN/CompatibleCgms/Libre2.md
similarity index 96%
rename from docs/EN/Hardware/Libre2.md
rename to docs/EN/CompatibleCgms/Libre2.md
index 8d892593c6c0..2c54a4294278 100644
--- a/docs/EN/Hardware/Libre2.md
+++ b/docs/EN/CompatibleCgms/Libre2.md
@@ -4,11 +4,11 @@ The Freestyle Libre 2 sensor is now a real CGM even with the official app. Still
## 1. Use a Bluetooth bridge and OOP
-Bluetooth transmitters can be used with the Libre 2 (EU) and an [out of process algorithm](https://drive.google.com/file/d/1f1VHW2I8w7Xe3kSQqdaY3kihPLs47ILS/view) app. You can receive blood sugar readings every 5 minutes like with the [Libre 1](../Libre1).
+Bluetooth transmitters can be used with the Libre 2 (EU) and an [out of process algorithm](https://drive.google.com/file/d/1f1VHW2I8w7Xe3kSQqdaY3kihPLs47ILS/view) app. You can receive blood sugar readings every 5 minutes like with the [Libre 1](./Libre1.md).
Check the bridge and app you want to use are compatible with your sensor and xDrip+ (older Blucon and recent ones won't work, Miaomiao 1 needs firmware 39 and Miaomiao 2 firmware 7).
-The Libre2 OOP is creating the same BG readings as with the original reader or the LibreLink app via NFC scan. AAPS with Libre 2 do a 10 to 25 minutes smoothing to avoid certain jumps. See below [Value smoothing & raw values](#value-smoothing-raw-values). OOP generates readings every 5 minutes with the average of the last 5 minutes. Therefore the BG readings are not that smooth but match the original reader device and faster follow the "real" BG readings. If you try to loop with OOP please enable all smoothing settings in xDrip+.
+The Libre2 OOP is creating the same BG readings as with the original reader or the LibreLink app via NFC scan. AAPS with Libre 2 do a 10 to 25 minutes smoothing to avoid certain jumps. See below [Value smoothing & raw values](#value-smoothing--raw-values). OOP generates readings every 5 minutes with the average of the last 5 minutes. Therefore the BG readings are not that smooth but match the original reader device and faster follow the "real" BG readings. If you try to loop with OOP please enable all smoothing settings in xDrip+.
There are some good reasons to use a Bluetooth transmitter:
@@ -32,7 +32,7 @@ xDrip+ doesn't support direct connection to Libre 2 US and AUS.
```
- Follow [these instructions](https://www.minimallooper.com/post/how-to-setup-freestyle-libre-2-and-oop2-to-use-a-native-bluetooth-connection-in-xdrip) to setup xDrip+ but make sure to download [this latest OOP2](https://drive.google.com/file/d/1f1VHW2I8w7Xe3kSQqdaY3kihPLs47ILS/view) as the one in the document is obsolete.
-- Follow setup instructions on [xDrip+ settings page](../Configuration/xdrip.md).
+- Follow setup instructions on [xDrip+ settings page](../CompatibleCgms/xDrip.md).
- Select xDrip+ in in [ConfigBuilder, BG Source](../Configuration/Config-Builder.md#bg-source).
@@ -203,8 +203,8 @@ be done.
The blood sugar values are received on the smartphone by the xDrip+ App.
- You can safely download the [latest APK (stable)](https://xdrip-plus-updates.appspot.com/stable/xdrip-plus-latest.apk) unless you need recent features, in which case you should use the latest [Nightly Snapshot](https://github.com/NightscoutFoundation/xDrip/releases).
-- Set xDrip+ with the [patched app data source](../Configuration/xdrip.md#lbre-2-patched-app).
-- Follow setup instructions on [xDrip+ settings page](../Configuration/xdrip.md).
+- Set xDrip+ with the [patched app data source](../CompatibleCgms/xDrip.md#libre-2-patched-app).
+- Follow setup instructions on [xDrip+ settings page](../CompatibleCgms/xDrip.md).
### Step 4: Start sensor
@@ -232,7 +232,7 @@ activation and make a new initial calibration.
- If AAPS does not receive BG values when phone is in airplane
mode, use 'Identify receiver' as describe on [xDrip+ settings
- page](xdrip-identify-receiver).
+ page](./xDrip.md#identify-receiver).
Until now, using Libre 2 as BG source you cannot activate ‘Enable SMB
always’ and ‘Enable SMB after carbs’ within SMB algorithm. The BG values
diff --git a/docs/EN/Hardware/Libre3.md b/docs/EN/CompatibleCgms/Libre3.md
similarity index 99%
rename from docs/EN/Hardware/Libre3.md
rename to docs/EN/CompatibleCgms/Libre3.md
index e807efb470ec..5f37c5936e89 100644
--- a/docs/EN/Hardware/Libre3.md
+++ b/docs/EN/CompatibleCgms/Libre3.md
@@ -34,7 +34,7 @@ Make sure you send the glucose values to Xdrip+: In Juggluco's settings you can
The blood glucose values are received by the xDrip+ app on the smartphone.
-- If not already set up then download [xDrip+](https://github.com/NightscoutFoundation/xDrip) and follow the instructions on [xDrip+ settings page](../Configuration/xdrip.md).
+- If not already set up then download [xDrip+](https://github.com/NightscoutFoundation/xDrip) and follow the instructions on [xDrip+ settings page](../CompatibleCgms/xDrip.md).
- In xDrip+ select "Libre2 (patched app)" as data source.
- If necessary, enter "BgReading:d,xdrip libre_receiver:v" under Less Common Settings → Extra Logging Settings → Extra tags for logging. This will log additional error messages for troubleshooting.
diff --git a/docs/EN/Hardware/MM640g.md b/docs/EN/CompatibleCgms/MM640g.md
similarity index 100%
rename from docs/EN/Hardware/MM640g.md
rename to docs/EN/CompatibleCgms/MM640g.md
diff --git a/docs/EN/Hardware/OttaiM8.md b/docs/EN/CompatibleCgms/OttaiM8.md
similarity index 100%
rename from docs/EN/Hardware/OttaiM8.md
rename to docs/EN/CompatibleCgms/OttaiM8.md
diff --git a/docs/EN/Hardware/PocTech.md b/docs/EN/CompatibleCgms/PocTech.md
similarity index 100%
rename from docs/EN/Hardware/PocTech.md
rename to docs/EN/CompatibleCgms/PocTech.md
diff --git a/docs/EN/Usage/Smoothing-Blood-Glucose-Data.md b/docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md
similarity index 98%
rename from docs/EN/Usage/Smoothing-Blood-Glucose-Data.md
rename to docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md
index b0f5cfdb9444..27276260e9ce 100644
--- a/docs/EN/Usage/Smoothing-Blood-Glucose-Data.md
+++ b/docs/EN/CompatibleCgms/SmoothingBloodGlucoseData.md
@@ -1,4 +1,3 @@
-(Smoothing-Blood-Glucose-Data)=
# Smoothing blood glucose data
If **BG** data is jumpy/noisy, **AAPS** may dose insulin incorrectly resulting in highs or lows. If you observe errors in your CGM data it is important to disable the loop until the problem is resolved. Depending on your CGM, such issues may be due to the CGM configuration in **AAPS** (as explained further below); or a CGM sensor site issue (which may require replacing the CGM sensor).
diff --git a/docs/EN/Hardware/SyaiTagX1.md b/docs/EN/CompatibleCgms/SyaiTagX1.md
similarity index 100%
rename from docs/EN/Hardware/SyaiTagX1.md
rename to docs/EN/CompatibleCgms/SyaiTagX1.md
diff --git a/docs/EN/Configuration/xdrip.md b/docs/EN/CompatibleCgms/xDrip.md
similarity index 97%
rename from docs/EN/Configuration/xdrip.md
rename to docs/EN/CompatibleCgms/xDrip.md
index d8356090cd1b..1988223dd7a8 100644
--- a/docs/EN/Configuration/xdrip.md
+++ b/docs/EN/CompatibleCgms/xDrip.md
@@ -74,7 +74,7 @@ Remember to disable Import Sounds to avoid xDrip+ making a ringtone every time A
* The Dexcom G6 transmitter can simultaneously be connected to the Dexcom receiver (or alternatively the t:slim pump) and one app on your phone.
* When using xDrip+ as receiver uninstall Dexcom app first. **You cannot connect xDrip+ and Dexcom app with the transmitter at the same time!**
-* If you need Clarity and want to profit from xDrip+ features, use the [Build Your Own Dexcom App](DexcomG6-if-using-g6-with-build-your-own-dexcom-app) with local broadcast to xDrip+, or use xDrip+ as a Companion app receiving notifications from the official Dexcom app.
+* If you need Clarity and want to profit from xDrip+ features, use the [Build Your Own Dexcom App](../CompatibleCgms/DexcomG6.md#if-using-g6-with-build-your-own-dexcom-app) with local broadcast to xDrip+, or use xDrip+ as a Companion app receiving notifications from the official Dexcom app.
### xDrip+ version depending on G6 transmitter serial no.
@@ -109,7 +109,7 @@ To learn more about the details and reasons for these recommendations read the [
### Connect G6 transmitter for the first time
-**For second and following transmitters see [Extend transmitter life](xdrip-extend-transmitter-life) below.**
+**For second and following transmitters see [Extend transmitter life](../CompatibleCgms/xDrip.md#extend-transmitter-life) below.**
Follow [these instructions](https://navid200.github.io/xDrip/docs/Starting-G6.html).
@@ -209,7 +209,7 @@ Follow [these instructions](https://navid200.github.io/xDrip/docs/Dexcom/SensorF
### Libre smart reader battery level
* Battery level of bridges such as MiaoMiao and Bubble can be displayed in AAPS (not Blucon).
-* Details can be found on [screenshots page](Screenshots-sensor-level-battery).
+* Details can be found on [screenshots page](../Getting-Started/Screenshots.md#sensor-level-battery).
### Connect Libre Transmitter & start sensor
diff --git a/docs/EN/Usage/huawei.md b/docs/EN/CompatiblePhones/Huawei.md
similarity index 100%
rename from docs/EN/Usage/huawei.md
rename to docs/EN/CompatiblePhones/Huawei.md
diff --git a/docs/EN/Usage/jelly.md b/docs/EN/CompatiblePhones/Jelly.md
similarity index 100%
rename from docs/EN/Usage/jelly.md
rename to docs/EN/CompatiblePhones/Jelly.md
diff --git a/docs/EN/CompatiblePhones/ListOfTestedPhones.md b/docs/EN/CompatiblePhones/ListOfTestedPhones.md
new file mode 100644
index 000000000000..3b30b6cd0fa2
--- /dev/null
+++ b/docs/EN/CompatiblePhones/ListOfTestedPhones.md
@@ -0,0 +1,27 @@
+(Phones-list-of-tested-phones)=
+# List of tested Phones compatible with Omnipod Dash Insulin Pump Pods
+
+Currently, we have a very hard-working behind-the-scenes Maintainer, who is in charge of ensuring the integrity of the Hardware List of all Android Phones/Smartwatches Capable of Looping with the Omnipod Dash; the newest pump driver addition to our ever-expanding network of Bluetooth enabled insulin pumps for use within the AAPS/OpenAPS ecosystem!
+
+Our Maintainer has spent a lot of time and effort to make sure that its easy for everyone to enter data into the Spreadsheet; via a Google Form with pre-populated information headers for ease of use! This ensures that the existing data on the sheets cannot be accidentally overwritten or deleted. The same experience can be built upon the success of the first again using Google Sheets.
+
+Thanks to the ease of Google Spreadsheets, close communication amongst early adopters and the ability of pooling their collective knowledge and lessons learned throughout early testing/feedback phases of the Dash pump pod drivers was compiled quite efficiently. The results of the time, information and energy provided by the numerous Early Adopters in providing step-by-step feedback on each new version of the Dash Bluetooth drivers becomes apparent once you open the up what is now a comprehensive Compare/Contrast list of all hardware suited for Looping with the Omnipod Dash, with many Android Phones and Smartwatches tested and ranked for compatibility. In addition, the more incompatible setups are also included in this Spreadshee so that new users will know which hardware to avoid due to issues with connection speed or strength.
+
+When the time comes for another Hardware Compatibility List to be created in the future; we encourage anyone that feels they might enjoy becoming a Maintainer to please contact us!
+
+The list of the tested phone can be accessed via the following link [list of tested phones with Omnipod insulin pump](https://docs.google.com/spreadsheets/d/1zO-Vf3wv0jji5Gflk6pe48oi348ApF5RvMcI6NG5TnY)
+
+With CRTL-F you can search in the text of the Google sheet. The sheet is write protected. To record your test of a phone please fill in the [form](https://forms.gle/g7GbSkMCTfFrWKjSA).
+
+After you fill in the form data the maintainer will check the data and approve it for publishing!
+
+Any problems with the spreadsheet please contact us directly or via a GitHub issue for the openaps/AndroidAPSDocs project.
+
+(Phones-phone-background)=
+# Phone Background
+
+
+
+Design: Thiago :)
+
+If you want to decorate your phone with more AAPS, you can download your background image here: 
diff --git a/docs/EN/Configuration/Accu-Chek-Combo-Pump-v2.md b/docs/EN/CompatiblePumps/Accu-Chek-Combo-Pump-v2.md
similarity index 94%
rename from docs/EN/Configuration/Accu-Chek-Combo-Pump-v2.md
rename to docs/EN/CompatiblePumps/Accu-Chek-Combo-Pump-v2.md
index 25d66f1da7ea..f53249968a1e 100644
--- a/docs/EN/Configuration/Accu-Chek-Combo-Pump-v2.md
+++ b/docs/EN/CompatiblePumps/Accu-Chek-Combo-Pump-v2.md
@@ -20,7 +20,7 @@ Some phones may work better than others, depending on their quality of Bluetooth
Be aware of the following limitations:
-* Extended bolus and multiwave bolus are currently not supported (you can use [Extended Carbs](../Usage/Extended-Carbs.rst) instead).
+* Extended bolus and multiwave bolus are currently not supported (you can use [Extended Carbs](../Usage/Extended-Carbs.md) instead).
* Only one basal profile (the first one) is supported.
* The loop is disabled if the currently active profile on the pump isn't profile no. 1. This continues until profile no. 1 is made the active one; when that is done, the next time AAPS connects (either on its own after a while or because the user presses the Refresh button in the combov2 user interface), it will notice that profile no. 1 is the current one, and enable the loop again.
* If the loop requests a running TBR to be cancelled, the Combo will set a TBR of 90% or 110% for 15 minutes instead. This is because actually cancelling a TBR causes an alert on the pump which causes a lot of vibrations, and these vibrations cannot be disabled.
@@ -95,7 +95,7 @@ It is very important to make sure that battery optimizations are turned off. AAP
## Activating the driver and pairing it with the Combo
-* Select the "Accu-Chek Combo" driver in the [Config builder](../Configuration/Config-Builder). **Important**: There is the old driver, called "Accu-Chek Combo (Ruffy)", in that list as well. Do _not_ select that one.
+* Select the "Accu-Chek Combo" driver in the [Config builder](../Configuration/Config-Builder.md). **Important**: There is the old driver, called "Accu-Chek Combo (Ruffy)", in that list as well. Do _not_ select that one.
@@ -165,7 +165,7 @@ The Combo can be operated through Bluetooth in the _remote-terminal_ mode or in
(The user does not influence this; the driver fully decides on its own what mode to use. This is merely a note for users to know why sometimes they can see Combo frames in that field.)
-At the very bottom, there is the "Refresh" button. This triggers an immediate pump status update. It also is used to let AAPS know that a previously discovered error is now fixed and that AAPS can check again that everything is OK (more on that below in [the section about alerts](combov2-alerts)).
+At the very bottom, there is the "Refresh" button. This triggers an immediate pump status update. It also is used to let AAPS know that a previously discovered error is now fixed and that AAPS can check again that everything is OK (more on that below in [the section about alerts](#alerts-warnings-and-errors-and-how-they-are-handled)).
## Preferences
@@ -176,8 +176,8 @@ These preferences are available for the combo driver (items are listed from top
1. _Pair with pump_: This is a button that can be pressed to pair with a Combo. It is disabled if a pump is already paired.
2. _Unpair pump_: Unpairs a paired Combo; the polar opposite of item no. 1. It is disabled if no pump is paired.
3. _Discovery duration (in seconds)_: When pairing, the drivers makes the phone discoverable by the pump. This controls how long that discoverability lasts. By default, the maximum (300 seconds = 5 minutes) is selected. Android does not allow for discoverability to last indefinitely, so a duration has to be chosen.
-4. _Autodetect and automatically enter insulin reservoir change_: If enabled, the "reservoir change" action that is normally done by the user through the "prime/fill" button in the Action tab. This is explained [in further detail below](combov2-autodetections).
-5. _Autodetect and automatically enter battery change_: If enabled, the "battery change" action that is normally done by the user through the "pump battery change" button in the Action tab. This is explained [in further detail below](combov2-autodetections).
+4. _Autodetect and automatically enter insulin reservoir change_: If enabled, the "reservoir change" action that is normally done by the user through the "prime/fill" button in the Action tab. This is explained [in further detail below](#autodetecting-and-automatically-entering-battery-and-reservoir-changes).
+5. _Autodetect and automatically enter battery change_: If enabled, the "battery change" action that is normally done by the user through the "pump battery change" button in the Action tab. This is explained [in further detail below](#autodetecting-and-automatically-entering-battery-and-reservoir-changes).
6. _Enable verbose Combo logging_: This greatly expands the amount of logging done by the driver. **CAUTION**: Do not enable this unless asked to by a developer. Otherwise, this can add a lot of noise to AndroidAPS logs and lessen their usefulness.
Most users only ever use the top two items, the _Pair with pump_ and _Unpair pump_ buttons.
@@ -202,7 +202,7 @@ Certain warnings are automatically dismissed by the driver. These are:
- W2 "battery low" : the driver turns this into a "low battery" warning that is shown on the AAPS main tab
- W3, W6, W7, W8 : these are all purely informational for the user, so it is safe for the driver to auto-dismiss them
-Other warnings are _not_ automatically dismissed. Also, errors are _never_ automatically dismissed. Both of these are handled the same way: They cause the driver to produce an alert dialog on top of the AAPS UI, and also cause it to abort any ongoing command execution. The driver then switches to the "error" state (see [the Accu-Chek Combo tab contents description above](combov2-tab-contents)). This state does not allow for any command execution. The user has to handle the error on the pump; for example, an occlusion error may require replacing the cannula. Once the user took care of the error, normal operation can be resumed by pressing the "Refresh" button on the Accu-Chek Combo tab. The driver then connects to the Combo and updates its status, checking for whether an error is still shown on screen etc. Also, the driver auto-refreshes the pump status after a while, so manually pressing that button is not mandatory.
+Other warnings are _not_ automatically dismissed. Also, errors are _never_ automatically dismissed. Both of these are handled the same way: They cause the driver to produce an alert dialog on top of the AAPS UI, and also cause it to abort any ongoing command execution. The driver then switches to the "error" state (see [the Accu-Chek Combo tab contents description above](#accu-chek-combo-tab-contents)). This state does not allow for any command execution. The user has to handle the error on the pump; for example, an occlusion error may require replacing the cannula. Once the user took care of the error, normal operation can be resumed by pressing the "Refresh" button on the Accu-Chek Combo tab. The driver then connects to the Combo and updates its status, checking for whether an error is still shown on screen etc. Also, the driver auto-refreshes the pump status after a while, so manually pressing that button is not mandatory.
Bolusing is a special case. It is done in the Combo's command mode, which does not report mid-bolus that an alert appeared. As a consequence, the driver cannot automatically dismiss warnings _during_ a bolus. This means that unfortunately, the pump will be beeping until the bolus is finished. The most common mid-bolus alert typically is W1 "reservoir low". **Don't** dismiss Comnbo warnings on the pump itself manually during a bolus. You risk interrupting the bolus. The driver will take care of the warning once the bolus is over.
@@ -215,8 +215,8 @@ Alerts that happen while the driver is not connected to the Combo will not be no
* Keep in mind that this is not a product, esp. in the beginning the user needs to monitor and understand the system, its limitations and how it can fail. It is strongly advised NOT to use this system when the person using it is not able to fully understand the system.
* Due to the way the Combo's remote control functionality works, several operations (especially setting a basal profile) are slow compared to other pumps. This is an unfortunate limitation of the Combo that cannot be overcome.
* Don't set or cancel a TBR on the pump. The loop assumes control of TBRs and cannot work reliably otherwise, since it's not possible to determine the start time of a TBR that was set by the user on the pump.
-* Don't press any buttons on the pump while AAPS communicates with the pump (the Bluetooth logo is shown on the pump while it is connected to AAPS). Doing that will interrupt the Bluetooth connection. Only do that if there are problems with establishing a connection (see [the "Before you begin" section above](combov2-before-you-begin)).
-* Don't press any buttons while the pump is bolusing. In particular, don't try to dismiss alerts by pressing buttons. See [the section about alerts](combov2-alerts) for a more detailed explanation why.
+* Don't press any buttons on the pump while AAPS communicates with the pump (the Bluetooth logo is shown on the pump while it is connected to AAPS). Doing that will interrupt the Bluetooth connection. Only do that if there are problems with establishing a connection (see [the "Before you begin" section above](#before-you-begin)).
+* Don't press any buttons while the pump is bolusing. In particular, don't try to dismiss alerts by pressing buttons. See [the section about alerts](#alerts-warnings-and-errors-and-how-they-are-handled) for a more detailed explanation why.
## Checklist for when no connection can be established with the Combo
diff --git a/docs/EN/Configuration/Accu-Chek-Combo-Pump.md b/docs/EN/CompatiblePumps/Accu-Chek-Combo-Pump.md
similarity index 97%
rename from docs/EN/Configuration/Accu-Chek-Combo-Pump.md
rename to docs/EN/CompatiblePumps/Accu-Chek-Combo-Pump.md
index 89d5bac39264..340c412c55ad 100644
--- a/docs/EN/Configuration/Accu-Chek-Combo-Pump.md
+++ b/docs/EN/CompatiblePumps/Accu-Chek-Combo-Pump.md
@@ -19,7 +19,7 @@
* Extended bolus and multiwave bolus are not supported (see [Extended Carbs](../Usage/Extended-Carbs.md) instead).
* Only one basal profile is supported.
* Setting a basal profile other than 1 on the pump or delivering extended boluses or multiwave boluses from the pump interferes with TBRs and forces the loop into low-suspend only mode for 6 hours as the the loop can't run safely under these conditions.
-* It's currently not possible to set the time and date on the pump, so [daylight saving time changes](Timezone-traveling-accu-chek-combo) have to be performed manually (you may disable the phone's automatic clock update in the evening and change it back in the morning together with the pump clock to avoid an alarm during the night).
+* It's currently not possible to set the time and date on the pump, so [daylight saving time changes](../Usage/Timezone-traveling.md#time-adjustment-daylight-savings-time-dst) have to be performed manually (you may disable the phone's automatic clock update in the evening and change it back in the morning together with the pump clock to avoid an alarm during the night).
* Currently only basal rates in the range of 0.05 to 10 U/h are supported. This also applies when modifying a profile, e.g. when increasing to 200%, the highest basal rate must not exceed 5 U/h since it will be doubled. Similarly, when reducing to 50%, the lowest basal rate must be at least 0.10 U/h.
* If the loop requests a running TBR to be cancelled the Combo will set a TBR of 90% or 110% for 15 minutes instead. This is because cancelling a TBR causes an alert on the pump which causes a lot of vibrations.
* Occasionally (every couple of days or so) AAPS might fail to automatically cancel a TBR CANCELLED alert, which the user then needs to deal with (by pressing the refresh button in AAPS to transfer the warning to AAPS or confirming the alert on the pump).
@@ -28,7 +28,7 @@
* There is another issue were a restart doesn't help but a button on the pump must be pressed (which resets the pump's Bluetooth), before the pump accepts connections from the phone again.
* There is very little that can be done to remedy either of those issues at this point. So if you see those errors frequently your only option at this time is to get another phone that's known to work well with AAPS and the Combo (see above).
* Issuing a bolus from the pump will not always be detected in time (checked for whenever AAPS connects to the pump), and might take up to 20 minutes in the worst case.
-* Boluses on the pump are always checked before a high TBR or a bolus issued by AAPS but due to the limitations AAPS will then refuse to issue the TBR/Bolus as it was calculated under false premises. (-> Don't bolus from the Pump! See chapter [Usage](Accu-Chek-Combo-Pump-usage) below)
+* Boluses on the pump are always checked before a high TBR or a bolus issued by AAPS but due to the limitations AAPS will then refuse to issue the TBR/Bolus as it was calculated under false premises. (-> Don't bolus from the Pump! See chapter [Usage](#usage) below)
* Setting a TBR on the pump is to be avoided since the loop assumes control of TBRs. Detecting a new TBR on the pump might take up to 20 minutes and the TBR's effect will only be accounted from the moment it is detected, so in the worst case there might be 20 minutes of a TBR that is not reflected in IOB.
## Setup
diff --git a/docs/EN/Configuration/Accu-Chek-Insight-Pump.md b/docs/EN/CompatiblePumps/Accu-Chek-Insight-Pump.md
similarity index 95%
rename from docs/EN/Configuration/Accu-Chek-Insight-Pump.md
rename to docs/EN/CompatiblePumps/Accu-Chek-Insight-Pump.md
index 1b4d1f88eec8..9227337ec9b1 100644
--- a/docs/EN/Configuration/Accu-Chek-Insight-Pump.md
+++ b/docs/EN/CompatiblePumps/Accu-Chek-Insight-Pump.md
@@ -18,7 +18,7 @@ you do with it.**
* A Roche Accu-Chek Insight pump (any firmware, they all work)
Note: AAPS will write data always in **first basal rate profile in the pump**.
-* An Android phone (Basically every Android version would work with Insight, but check on the [Module](module-phone) page which Android version is required to run AAPS.)
+* An Android phone (Basically every Android version would work with Insight, but check on the [Module](../Module/module.md) page which Android version is required to run AAPS.)
* The AAPS app installed on your phone
## Setup
@@ -27,7 +27,7 @@ Note: AAPS will write data always in **first basal rate profile in the pump**.
-* In [Config builder](../Configuration/Config-Builder) of the AAPS app select Accu-Chek Insight in the pump section
+* In [Config builder](../Configuration/Config-Builder.md) of the AAPS app select Accu-Chek Insight in the pump section
@@ -57,7 +57,7 @@ Note: There will be no permanent connection between pump and phone. A connection
(Accu-Chek-Insight-Pump-settings-in-aaps)=
## Settings in AAPS
-**Note : It is now possible (only with AAPS v2.7.0 and above) to use ‘Always use basal absolute values’ if you want to use Autotune with Insight pump, even if 'sync is enabled' with Nightscout.** (In AAPS go to [Preferences > NSClient > Advanced Settings](Preferences-advanced-settings-nsclient)).
+**Note : It is now possible (only with AAPS v2.7.0 and above) to use ‘Always use basal absolute values’ if you want to use Autotune with Insight pump, even if 'sync is enabled' with Nightscout.** (In AAPS go to [Preferences > NSClient > Advanced Settings](../Configuration/Preferences.md#advanced-settings-nsclient)).
@@ -119,7 +119,7 @@ Depending on the firmware version of your pump, the Insight will vibrate briefly
* Firmware 1.x: No vibration by design.
* Firmware 2.x: Vibration cannot be disabled.
-* Firmware 3.x: AAPS delivers bolus silently. (minimum [version 2.6.1.4](Releasenotes-version-2-6-1-4))
+* Firmware 3.x: AAPS delivers bolus silently. (minimum [version 2.6.1.4](../Installing-AndroidAPS/Releasenotes.md#version-2.6.1.4))
Firmware version can be found in the menu.
@@ -146,5 +146,5 @@ In this case turn off bluetooth on pump AND smartphone for about 10 seconds and
## Crossing time zones with Insight pump
-For information on traveling across time zones see section [Timezone traveling with pumps](Timezone-traveling-insight).
+For information on traveling across time zones see section [Timezone traveling with pumps](../Usage/Timezone-traveling.md#insight).
diff --git a/docs/EN/Configuration/DanaR-Insulin-Pump.md b/docs/EN/CompatiblePumps/DanaR-Insulin-Pump.md
similarity index 91%
rename from docs/EN/Configuration/DanaR-Insulin-Pump.md
rename to docs/EN/CompatiblePumps/DanaR-Insulin-Pump.md
index fe42851921e7..fae7e6829450 100644
--- a/docs/EN/Configuration/DanaR-Insulin-Pump.md
+++ b/docs/EN/CompatiblePumps/DanaR-Insulin-Pump.md
@@ -1,6 +1,6 @@
# DanaR Pump
-_These instructions are for configuring the app and your pump if you have a DanaR. Visit [DanaRS Insulin Pump](./DanaRS-Insulin-Pump) if you have the DanaRS launched in 2017 instead._
+_These instructions are for configuring the app and your pump if you have a DanaR. Visit [DanaRS Insulin Pump](./DanaRS-Insulin-Pump.md) if you have the DanaRS launched in 2017 instead._
* In the pump go to Main Menu > Setting > User Option
* Turn on "8. Extended Bolus"
@@ -22,4 +22,4 @@ _These instructions are for configuring the app and your pump if you have a Dana
## Timezone traveling with Dana R pump
-For information on traveling across time zones see section [Timezone traveling with pumps](Timezone-traveling-danarv2-danars).
+For information on traveling across time zones see section [Timezone traveling with pumps](../Usage/Timezone-traveling.md#danarv2-danars).
diff --git a/docs/EN/Configuration/DanaRS-Insulin-Pump.md b/docs/EN/CompatiblePumps/DanaRS-Insulin-Pump.md
similarity index 89%
rename from docs/EN/Configuration/DanaRS-Insulin-Pump.md
rename to docs/EN/CompatiblePumps/DanaRS-Insulin-Pump.md
index d2b219885ad9..6ea2ce0f3a26 100644
--- a/docs/EN/Configuration/DanaRS-Insulin-Pump.md
+++ b/docs/EN/CompatiblePumps/DanaRS-Insulin-Pump.md
@@ -1,6 +1,6 @@
# DanaRS and Dana-i Pump
-_These instructions are for configuring the app and your pump if you have a DanaRS from 2017 onwards or the newer Dana-i. Visit [DanaR Insulin Pump](./DanaR-Insulin-Pump) if you have the original DanaR instead._
+_These instructions are for configuring the app and your pump if you have a DanaRS from 2017 onwards or the newer Dana-i. Visit [DanaR Insulin Pump](./DanaR-Insulin-Pump.md) if you have the original DanaR instead._
**New Dana RS firmware v3 can be used from AAPS version 2.7 onwards.**
@@ -69,7 +69,7 @@ _These instructions are for configuring the app and your pump if you have a Dana
* Press OK to enter old password.
-* Enter **old password** (Default password see [above](DanaRS-Insulin-Pump-default-password)) and press OK
+* Enter **old password** (Default password see [above](#default-password)) and press OK
@@ -97,25 +97,25 @@ In case the connection between AAPS and Dana RS is lost during bolus insulin del
* In most cases this is just a communication issue and the correct amount of insulin is delivered.
* Check in pump history (either on the pump or through Dana tab > pump history > boluses) if correct bolus is given.
-* Delete error entry in [treatments tab](Screenshots-carb-correction) if you wish.
+* Delete error entry in [treatments tab](../Getting-Started/Screenshots.md#carb-correction) if you wish.
* Real amount is read and recorded on next connect. To force this press BT icon on dana tab or just wait for next connect.
## Special note when switching phone
When switching to a new phone the following steps are necessary:
-* [Export settings](ExportImportSettings-export-settings) on your old phone
+* [Export settings](../Usage/ExportImportSettings.md) on your old phone
* Transfer settings from old to new phone
### DanaRS v1
* **Manually pair** Dana RS with the new phone
* As pump connection settings are also imported AAPS on your new phone will already "know" the pump and therefore not start a bluetooth scan. Therefore new phone and pump must be paired manually.
* Install AAPS on the new phone.
-* [Import settings](ExportImportSettings-import-settings) on your new phone
+* [Import settings](../Usage/ExportImportSettings.md) on your new phone
### DanaRS v3, Dana-i
-* Start pairing procedure like decribed [above](DanaRS-Insulin-Pump-pairing-pump).
+* Start pairing procedure like decribed [above](#pairing-pump).
* Sometimes it may be necessary to clear pairing information in AAPS by long-click BT icon on Dana-i/RS tab.
## Timezone traveling with Dana RS pump
-For information on traveling across time zones see section [Timezone traveling with pumps](Timezone-traveling-danarv2-danars).
+For information on traveling across time zones see section [Timezone traveling with pumps](../Usage/Timezone-traveling.md#danarv2-danars).
diff --git a/docs/EN/Configuration/DiaconnG8.md b/docs/EN/CompatiblePumps/DiaconnG8.md
similarity index 94%
rename from docs/EN/Configuration/DiaconnG8.md
rename to docs/EN/CompatiblePumps/DiaconnG8.md
index 4adb4de68db5..461b427e50ae 100644
--- a/docs/EN/Configuration/DiaconnG8.md
+++ b/docs/EN/CompatiblePumps/DiaconnG8.md
@@ -88,4 +88,4 @@
### Extended Bolus function
- If you use extended bolus it will disable closed loop.
-- See [this page](Extended-Carbs-why-extended-boluses-won-t-work-in-a-closed-loop-environment) for details why extended bolus does not work in a closed loop environment.
+- See [this page](../Usage/Extended-Carbs.md#why-extended-boluses-wont-work-in-a-closed-loop-environment) for details why extended bolus does not work in a closed loop environment.
diff --git a/docs/EN/Configuration/EOPatch2.md b/docs/EN/CompatiblePumps/EOPatch2.md
similarity index 100%
rename from docs/EN/Configuration/EOPatch2.md
rename to docs/EN/CompatiblePumps/EOPatch2.md
diff --git a/docs/EN/Getting-Started/Future-possible-Pump-Drivers.md b/docs/EN/CompatiblePumps/Future-possible-Pump-Drivers.md
similarity index 100%
rename from docs/EN/Getting-Started/Future-possible-Pump-Drivers.md
rename to docs/EN/CompatiblePumps/Future-possible-Pump-Drivers.md
diff --git a/docs/EN/Configuration/MedtronicPump.md b/docs/EN/CompatiblePumps/MedtronicPump.md
similarity index 98%
rename from docs/EN/Configuration/MedtronicPump.md
rename to docs/EN/CompatiblePumps/MedtronicPump.md
index 390f0758deee..dcc98c834058 100644
--- a/docs/EN/Configuration/MedtronicPump.md
+++ b/docs/EN/CompatiblePumps/MedtronicPump.md
@@ -48,7 +48,7 @@ When configuring your Medtronic pump with the setup wizard it is possible that y
While setting up AAPS to work with your medtronic pump you need to set following items: (see picture above)
- **Pump Serial Number**: Displayed on the back of your pump and starts with SN. You should only enter the 6 numbers shown without any alpabetic characters (e.g. 123456).
- **Pump Type**: The model pump you are using (e.g. 522).
-- **Pump Frequency**: There are two options based on where your pump was originally distributed. Please check the [FAQ](MedtronicPump-faq) if you are unsure which option to select):
+- **Pump Frequency**: There are two options based on where your pump was originally distributed. Please check the [FAQ](#faq) if you are unsure which option to select):
- for US & Canada, frequency used is 916 Mhz
- for Worldwide, frequency used is 868 Mhz
- **Max Basal on Pump (U/h)**: This needs to match the setting set on your pump (see Configuration of the pump above). Again this setting must be carefully selected as it will determine how much AAPS can deliver via your basal rate. This will effectively set the maximum temporary basal rate. As an example, setting this value to four times your maximum standard basal rate would allow a 400% Temporary Basal Rate. The maximum value permitted by the pump is 34.9 units per hour.
@@ -85,8 +85,8 @@ When AAPS is configured to use a Medtronic pump a MDT tab will be shown in the l
At the bottom of the screen there are three buttons:
- **Refresh** is for refreshing the current status of the pump. This should only be used if the connection was lost for a sustained period as this will require a full data refresh (retrieve history, get/set time, get profile, get battery status, etc).
-- **Pump History**: Shows pump history (see [below](MedtronicPump-pump-history))
-- **RL Stats**: Show RL Stats (see [below](MedtronicPump-rl-status-rileylink-status))
+- **Pump History**: Shows pump history (see [below](#pump-history))
+- **RL Stats**: Show RL Stats (see [below](#rl-status-rileylink-status))
(MedtronicPump-pump-history)=
## Pump History
diff --git a/docs/EN/Configuration/MedtrumNano.md b/docs/EN/CompatiblePumps/MedtrumNano.md
similarity index 98%
rename from docs/EN/Configuration/MedtrumNano.md
rename to docs/EN/CompatiblePumps/MedtrumNano.md
index f2a242a57e8d..66bc19e3030d 100644
--- a/docs/EN/Configuration/MedtrumNano.md
+++ b/docs/EN/CompatiblePumps/MedtrumNano.md
@@ -15,10 +15,10 @@ This software is part of a DIY artificial pancreas solution and is not a product
- Medtrum TouchCare Nano with pumpbase refs: **MD0201** and **MD8201**.
- Medtrum TouchCare 300U with pumpbase ref: **MD8301**.
- If you have an unsupported model and are willing to donate hardware or assist with testing, please contact us via discord [here](https://discordapp.com/channels/629952586895851530/1076120802476441641).
-* **Version 3.2.0.0 or newer of AAPS built and installed** using the [Build APK](../Installing-AndroidAPS/Building-APK.md) instructions.
+* **Version 3.2.0.0 or newer of AAPS built and installed** using the [Build APK](../Installing-AndroidAPS/building-AAPS.md) instructions.
* **Compatible Android phone** with a BLE Bluetooth connection
- See AAPS [Release Notes](../Installing-AndroidAPS/Releasenotes.md)
-* [**Continuous Glucose Monitor (CGM)**](BG-Source.md)
+* [**Continuous Glucose Monitor (CGM)**](../Getting-Started/CompatiblesCgms.md)
## Before you begin
@@ -56,7 +56,7 @@ If in doubt you can also select “Virtual Pump” and select “Medtrum” late
#### Option 2: The Config Builder
-On an existing installation you can select the **Medtrum** pump from the [Config Builder](Config-Builder.md#config-builder-profile):
+On an existing installation you can select the **Medtrum** pump from the [Config Builder](../Configuration/Config-Builder.md#pump):
On the top-left hand corner **hamburger menu** select **Config Builder**\ ➜\ **Pump**\ ➜\ **Medtrum**\ by selecting the **Enable button** titled **Medtrum**.
diff --git a/docs/EN/Configuration/OmnipodDASH.md b/docs/EN/CompatiblePumps/OmnipodDASH.md
similarity index 97%
rename from docs/EN/Configuration/OmnipodDASH.md
rename to docs/EN/CompatiblePumps/OmnipodDASH.md
index 1dbcb5b70108..e961a3888a53 100644
--- a/docs/EN/Configuration/OmnipodDASH.md
+++ b/docs/EN/CompatiblePumps/OmnipodDASH.md
@@ -27,8 +27,8 @@ These are the specifications of the **Omnipod DASH** and what differentiates it
Please check [**DASH Tested phones**](https://docs.google.com/spreadsheets/d/1zO-Vf3wv0jji5Gflk6pe48oi348ApF5RvMcI6NG5TnY) or just try with your phone and tell us the result (phone reference and geographical region, Android version, worked / some difficulties / did not work).
- **Important note: There have been multiple cases of permanent, non-recoverable connection losses when using older pods with firmware version 3.XX.X. Be careful when using these old pods with AAPS, especially with other Bluetooth devices connected!**
Be aware that AAPS Omnipod Dash driver Connects with the Dash POD via Bluetooth every time it sends a command, and it disconnects right after. The Bluetooth connections might be disturbed by other devices linked to the phone that is running AAPS, like earbuds etc... (which might cause, in rare occasions, connection issue or pod errors/loss on activation or afterwards in some phone models), or be disturbed by it.
- - **Version 3.0 or newer of AAPS built and installed** using the [**Build APK**](../Installing-AndroidAPS/Building-APK.md) instructions.
-* [**Continuous Glucose Monitor (CGM)**](../Configuration/BG-Source.md)
+ - **Version 3.0 or newer of AAPS built and installed** using the [**Build APK**](../Installing-AndroidAPS/building-AAPS.md) instructions.
+* [**Continuous Glucose Monitor (CGM)**](../Getting-Started/CompatiblesCgms.md)
These instructions will assume that you are starting a new pod session; if this is not the case, please be patient and begin this process on your following pod change.
@@ -71,7 +71,7 @@ On the top-left hand corner **hamburger menu** select **Config Builder (1)**\
Selecting the **checkbox (4)** next to the **Settings Gear (3)** will allow the Dash menu to be displayed as a tab in the AAPS interface titled **DASH**. Checking this box will facilitate your access to the DASH commands when using AAPS.
-**NOTE:** A faster way to access the [**Dash settings**](DanaRS-Insulin-Pump-dash-settings) can be found below in the Dash settings section of this document.
+**NOTE:** A faster way to access the [**Dash settings**](#dash-settings) can be found below in the Dash settings section of this document.
@@ -137,7 +137,7 @@ Ensure that the new pod and the phone running AAPS are within close proximity of
Click on the back button on your phone to return to the **DASH** tab screen which will now display Pod information for your active pod session, including current basal rate, pod reservoir level, insulin delivered, pod errors and alerts.
- For more details on the information displayed go to the [**DASH Tab**](OmnipodDASH-dash-tab) section of this document.
+ For more details on the information displayed go to the [**DASH Tab**](#dash-tab) section of this document.
 
@@ -176,7 +176,7 @@ To deactivate a pod (either from expiration or from a pod failure):
### Resuming Insulin Delivery
-**Note**: During profile switches, dash must suspend delivery before setting the new basal profile. If communication fails between the two commands, then delivery can be suspended. Read [**Delivery suspended**](OmnipodDASH) in the troubleshooting section for more details.
+**Note**: During profile switches, dash must suspend delivery before setting the new basal profile. If communication fails between the two commands, then delivery can be suspended. Read [**Delivery suspended**](#delivery-suspended) in the troubleshooting section for more details.
Use this command to instruct the active, currently suspended pod to resume insulin delivery. After the command is successfully processed, insulin will resume normal delivery using the current basal rate based on the current time from the active basal profile. The pod will again accept commands for bolus, TBR, and SMB.
@@ -267,7 +267,7 @@ Below is an explanation of the layout and meaning of the icons and status fields
* **Reservoir:** Displays over 50+U left when more than 50 units are left in the reservoir. Below 50 U, the exact units are displayed.
* **Total delivered:** Displays the total number of units of insulin delivered from the reservoir. This includes insulin used for activating and priming.
-* **Errors:** Displays the last error encountered. Review the [Pod history](OmnipodDASH-view-pod-history) and log files for past errors and more detailed information.
+* **Errors:** Displays the last error encountered. Review the [Pod history](#view-pod-history) and log files for past errors and more detailed information.
* **Active pod alerts:** Reserved for currently running alerts on the active pod.
### Buttons
@@ -292,10 +292,10 @@ Below is an explanation of the layout and meaning of the icons and status fields
Below is the meaning of the icons on the **Pod Management** menu accessed by pressing **POD MGMT (0)** button from the **DASH** tab.
 
-* 1 - [**Activate Pod**](OmnipodDASH-activate-pod) : Primes and activates a new pod.
-* 2 - [**Deactivate Pod**](OmnipodDASH-deactivate-pod) : Deactivates the currently active pod.
+* 1 - [**Activate Pod**](#activate-pod) : Primes and activates a new pod.
+* 2 - [**Deactivate Pod**](#deactivate-pod) : Deactivates the currently active pod.
* 3 - **Play Test Beep** : Plays a single test beep on the pod when pressed.
-* 4 - [**Pod history**](OmnipodDASH-view-pod-history) : Displays the active pod activity history.
+* 4 - [**Pod history**](#view-pod-history) : Displays the active pod activity history.
(DanaRS-Insulin-Pump-dash-settings)=
@@ -382,7 +382,7 @@ Additional note:
- There might be notification that one of the commands is unconfirmed: this depends on when the failure happened.
- AAPS will try to set the new basal profile every 15 minutes.
- AAPS will show a notification informing that the delivery is suspended every 15min, if the delivery is still suspended (resume delivery failed).
- - The [**Resume delivery**](OmnipodDASH-resuming-insulin-delivery) button will be active if the user chooses to resume delivery manually.
+ - The [**Resume delivery**](#resuming-insulin-delivery) button will be active if the user chooses to resume delivery manually.
- If AAPS fail to resume delivery on its own (this happens if the Pod is unreachable, sound is muted, etc), the pod will start beeping 4 time every minute for 3 minutes, then repeated every 15 minutes if delivery is still suspended for more than 20minutes.
* For unconfirmed commands, "refresh pod status" should confirm/deny them.
diff --git a/docs/EN/Configuration/OmnipodEros.md b/docs/EN/CompatiblePumps/OmnipodEros.md
similarity index 97%
rename from docs/EN/Configuration/OmnipodEros.md
rename to docs/EN/CompatiblePumps/OmnipodEros.md
index 79a063f6d0d9..31848e8ae931 100644
--- a/docs/EN/Configuration/OmnipodEros.md
+++ b/docs/EN/CompatiblePumps/OmnipodEros.md
@@ -65,7 +65,7 @@ On the **RileyLink Selection** screen press the **Scan** button and select your
Press the **Next** button to proceed with the rest of the **Setup Wizard.** It can take up to one minute for the selected RileyLink to initialize and the **Next** button to become active.
-Detailed steps on how to setup your pod communication device are listed below in the [RileyLink Setup Section](OmnipodEros-rileylink-setup).
+Detailed steps on how to setup your pod communication device are listed below in the [RileyLink Setup Section](#rileylink-setup).
**OR**
@@ -73,7 +73,7 @@ Detailed steps on how to setup your pod communication device are listed below in
Via the top-left hand corner **hamburger menu** under **Config Builder (1)** ➜**Pump**➜**Omnipod** by selecting the **radio button (2)** titled **Omnipod**. Selecting the **checkbox (4)** next to the **Settings Gear (3)** will display the Omnipod menu as a tab in the AAPS interface titled **POD**. This is referred to in this documentation as the **Omnipod (POD)** tab.
-> **NOTE:** A faster way to access the **Omnipod settings** can be found below in the [Omnipod Settings section](OmnipodEros-omnipod-settings) of this document.
+> **NOTE:** A faster way to access the **Omnipod settings** can be found below in the [Omnipod Settings section](#omnipod-settings) of this document.
>
>  
@@ -97,7 +97,7 @@ Please **swipe left** to the **Omnipod (POD)** tab where you will be able to man
### RileyLink Setup
-If you already successfully paired your RileyLink in the Setup Wizard or steps above, then proceed to the [Activating a Pod Section](OmnipodEros-activating-a-pod) below.
+If you already successfully paired your RileyLink in the Setup Wizard or steps above, then proceed to the [Activating a Pod Section](#activating-a-pod) below.
*Note: A good visual indicator that the RileyLink is not connected is that the Insulin and Calculator buttons on the HOME tab will be missing. This will also occur for about the first 30 seconds after AAPS starts, as it is actively connecting to the RileyLink.*
@@ -105,7 +105,7 @@ If you already successfully paired your RileyLink in the Setup Wizard or steps a
2. After selecting the Omnipod driver, identify and select your RileyLink from **Config Builder (1)** ➜**Pump**➜**Omnipod**➜**Gear Icon (Settings) (2)** ➜**RileyLink Configuration (3)** by pressing the **Not Set** or **MAC Address (if present)** text.
- > Ensure your RileyLink battery is charged and it is [positioned in close proximity](OmnipodEros-optimal-omnipod-and-rileylink-positioning) (~30 cm away or less) to your phone for AAPS to identify it by its MAC address. Once selected, you can proceed to activate your first pod session. Use the back button on your phone to return to the main AAPS interface.
+ > Ensure your RileyLink battery is charged and it is [positioned in close proximity](#optimal-omnipod-and-rileylink-positioning) (~30 cm away or less) to your phone for AAPS to identify it by its MAC address. Once selected, you can proceed to activate your first pod session. Use the back button on your phone to return to the main AAPS interface.
>
>  
@@ -127,7 +127,7 @@ If you already successfully paired your RileyLink in the Setup Wizard or steps a
Before you can activate a pod please ensure you have properly configured and connected your RileyLink connection in the Omnipod settings
-*REMINDER: Pod communication occurs at limited ranges for pod activation pairing due to security safety measures. Before pairing the Pod's radio signal is weaker, however after it has been paired it will operate at full signal power. During these procedures, make sure that your pod is* [within close proximity](OmnipodEros-optimal-omnipod-and-rileylink-positioning) (~30 cm away or less) but not on top of or right next to the RileyLink.\*
+*REMINDER: Pod communication occurs at limited ranges for pod activation pairing due to security safety measures. Before pairing the Pod's radio signal is weaker, however after it has been paired it will operate at full signal power. During these procedures, make sure that your pod is* [within close proximity](#optimal-omnipod-and-rileylink-positioning) (~30 cm away or less) but not on top of or right next to the RileyLink.\*
01. Navigate to the **Omnipod (POD)** tab and click on the **POD MGMT (1)** button, and then click on **Activate Pod (2)**.
@@ -139,7 +139,7 @@ Before you can activate a pod please ensure you have properly configured and con
>
> Ensure the new pod and RileyLink are within close proximity of each other (~30cm or less) and click the **Next** button.
-03. On the **Initialize Pod** screen, the pod will begin priming (you will hear a click followed by a series of ticking sounds as the pod primes itself). If RileyLink is out of range of the pod being activated, you will receive an error message **No response from Pod**. If this occurs, [move the RileyLink closer](OmnipodEros-optimal-omnipod-and-rileylink-positioning) (~30 cm away or less) to but not on top of or right next to the Pod and click the **Retry (1)** button.
+03. On the **Initialize Pod** screen, the pod will begin priming (you will hear a click followed by a series of ticking sounds as the pod primes itself). If RileyLink is out of range of the pod being activated, you will receive an error message **No response from Pod**. If this occurs, [move the RileyLink closer](#optimal-omnipod-and-rileylink-positioning) (~30 cm away or less) to but not on top of or right next to the Pod and click the **Retry (1)** button.
>  
@@ -179,7 +179,7 @@ Before you can activate a pod please ensure you have properly configured and con
Click on the back button on your phone to return to the **Omnipod (POD)** tab screen which will now display Pod information for your active pod session, including current basal rate, pod reservoir level, insulin delivered, pod errors and alerts.
- For more details on the information displayed go to the [Omnipod (POD) Tab](OmnipodEros-omnipod-pod-tab) section of this document.
+ For more details on the information displayed go to the [Omnipod (POD) Tab](#omnipod-pod-tab) section of this document.
 
@@ -221,7 +221,7 @@ To deactivate a pod (either from expiration or from a pod failure):
The process below will show you how to suspend and resume insulin pump delivery.
-*NOTE - if you do not see a SUSPEND button*, then it has not been enabled to display in the Omnipod (POD) tab. Enable the **Show Suspend Delivery button in Omnipod tab** setting in the [Omnipod settings](OmnipodEros-omnipod-settings) under **Other**.
+*NOTE - if you do not see a SUSPEND button*, then it has not been enabled to display in the Omnipod (POD) tab. Enable the **Show Suspend Delivery button in Omnipod tab** setting in the [Omnipod settings](#omnipod-settings) under **Other**.
#### Suspending Insulin Delivery
@@ -429,7 +429,7 @@ Below is an explanation of the layout and meaning of the icons and status fields
- **Total delivered:** Displays the total number of units of insulin delivered from the reservoir. *Note this is an approximation as priming and filling the pod is not an exact process.*
-- **Errors:** Displays the last error encountered. Review the [Pod history](OmnipodEros-view-pod-history), [RileyLink history](OmnipodEros-rileylink-and-active-pod-history) and log files for past errors and more detailed information.
+- **Errors:** Displays the last error encountered. Review the [Pod history](#view-pod-history), [RileyLink history](#rileylink-and-active-pod-history) and log files for past errors and more detailed information.
- **Active pod alerts:** Reserved for currently running alerts on the active pod. Normally used when pod expiration is past 72 hours and native pod beep alerts are running.
@@ -443,7 +443,7 @@ Below is an explanation of the layout and meaning of the icons and status fields
>
> Use to refresh the pod status and dismiss status fields that contain the text (uncertain).
>
- > See the [Troubleshooting section](OmnipodEros-troubleshooting) below for additional information.
+ > See the [Troubleshooting section](#troubleshooting) below for additional information.
- **POD MGMT:**
@@ -547,7 +547,7 @@ Below is an explanation of the layout and meaning of the icons on the **Pod Mana
> > > - Communication Protocols are set
> > > - Tuned Radio Frequency is set
> >
- > > - See [additional notes](OmnipodEros-reset-rileylink-config-notes) at the end of this table
+ > > - See [additional notes](#reset-rileylink-config-notes) at the end of this table
- **Read pulse log:**
diff --git a/docs/EN/Configuration/BG-Source.md b/docs/EN/Configuration/BG-Source.md
deleted file mode 100644
index e95c7239bc22..000000000000
--- a/docs/EN/Configuration/BG-Source.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# CGMS/FGMS Configuration
-
-* [General](../Hardware/GeneralCGMRecommendation.md)
-* [Data Smoothing](../Usage/Smoothing-Blood-Glucose-Data.md)
-* [xDrip+Settings](./xdrip.md)
-* [Dexcom G7 and ONE+](../Hardware/DexcomG7.md)
-* [Dexcom G6 and ONE](../Hardware/DexcomG6.md)
-* [Dexcom G5](../Hardware/DexcomG5.md)
-* [Libre 3](../Hardware/Libre3.md)
-* [Libre 2](../Hardware/Libre2.md)
-* [Libre 1](../Hardware/Libre1.md)
-* [Eversense](../Hardware/Eversense.md)
-* [MM640g/MM630g](../Hardware/MM640g.md)
-* [PocTech](../Hardware/PocTech.md)
-* [Nightscout as BG Source](../Hardware/CgmNightscoutUpload.md)
diff --git a/docs/EN/Configuration/Config-Builder.md b/docs/EN/Configuration/Config-Builder.md
index 96cd169804df..928192c0f7cc 100644
--- a/docs/EN/Configuration/Config-Builder.md
+++ b/docs/EN/Configuration/Config-Builder.md
@@ -54,12 +54,12 @@ You can easily create a new local profile from a profile switch. In this case ti
(Config-Builder-upload-local-profiles-to-nightscout)=
#### Upload local profiles to Nightscout
-Local profiles can also be uploaded to Nightscout. The settings can be found in [NSClient preferences](Preferences-nsclient).
+Local profiles can also be uploaded to Nightscout. The settings can be found in [NSClient preferences](../Configuration/Preferences.md#nsclient).
#### Change profile in Nighscout profile editor
-You can synchronize changes to the profile in the Nighscout profile editor to local profiles. The settings can be found in [NSClient preferences](Preferences-nsclient).
+You can synchronize changes to the profile in the Nighscout profile editor to local profiles. The settings can be found in [NSClient preferences](../Configuration/Preferences.md#nsclient).
It is necessary to clone the actual active entire Nightscout database records for the profiles and not just a profile with the blue arrow! The new database records then carries the current date and can be activated via the tab "local profile".
@@ -91,12 +91,12 @@ Details are explained on the separate [profile helper page](../Configuration/pro
* The DIA is not the same for each person. That's why you have to test it for yourself.
* But it must always be at least 5 hours.
* For a lot of people using ultra-rapid insulins like Fiasp there is practically no noticeable effect after 3-4 hours any more, even if 0.0xx units are available as a rule then. This residual amount can still be noticeable during sports, for example. Therefore, AAPS uses minimum 5h as DIA.
-* You can read more about that in the Insulin Profile section of [this](Screenshots-insulin-profile) page.
+* You can read more about that in the Insulin Profile section of [this](../Getting-Started/Screenshots.md#insulin-profile) page.
### Insulin type differences
* For 'Rapid-Acting', 'Ultra-Rapid' and 'Lyumjev' the DIA is the only variable you can adjust by yourself, the time to peak is fixed.
* Free-Peak allows you to adjust both the DIA and the time to peak, and must only be used by advanced users who know the effects of these settings.
-* The [insulin curve graph](Screenshots-insulin-profile) helps you to understand the different curves.
+* The [insulin curve graph](../Getting-Started/Screenshots.md#insulin-profile) helps you to understand the different curves.
* You can view it by enabling the tickbox to show it as a tab, otherwise it will be in the hamburger menu.
#### Rapid-Acting Oref
@@ -134,7 +134,7 @@ Details are explained on the separate [profile helper page](../Configuration/pro
(Config-Builder-bg-source)=
## BG Source
-Select the blood glucose source you are using - see [BG Source](BG-Source.md) page for more setup information.
+Select the blood glucose source you are using - see [BG Source](../Getting-Started/CompatiblesCgms.md) page for more setup information.
@@ -154,27 +154,27 @@ Select the pump you are using.
-* [Dana R](DanaR-Insulin-Pump.md)
+* [Dana R](../CompatiblePumps/DanaR-Insulin-Pump.md)
* Dana R Korean (for domestic DanaR pump)
* Dana Rv2 (DanaR pump with unofficial firmware upgrade)
-* [Dana-i/RS](DanaRS-Insulin-Pump.md)
+* [Dana-i/RS](../CompatiblePumps/DanaRS-Insulin-Pump.md)
* For dana pumps, use Advanced settings to activate BT watchdog if necessary. It switches off bluetooth for one second if no connection to the pump is possible. This may help on some phones where the bluetooth stack freezes.
- * [Password for Dana RS pump](../Configuration/DanaRS-Insulin-Pump.md) must be entered correctly. Password was not checked in previous versions.
-
-* [Accu Chek Insight](Accu-Chek-Insight-Pump.md)
-* [Accu Chek Combo](Accu-Chek-Combo-Pump.md) (requires ruffy installation)
-* [Omnipod Eros](OmnipodEros.md)
-* [Omnipod DASH](OmnipodDASH.md)
-* [Medtronic](MedtronicPump.md)
-* [Diaconn G8](DiaconnG8.md)
+ * [Password for Dana RS pump](../CompatiblePumps/DanaRS-Insulin-Pump.md) must be entered correctly. Password was not checked in previous versions.
+
+* [Accu Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md)
+* [Accu Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump.md) (requires ruffy installation)
+* [Omnipod Eros](../CompatiblePumps/OmnipodEros.md)
+* [Omnipod DASH](../CompatiblePumps/OmnipodDASH.md)
+* [Medtronic](../CompatiblePumps/MedtronicPump.md)
+* [Diaconn G8](../CompatiblePumps/DiaconnG8.md)
- MDI (receive AAPS suggestions for your multiple daily injections therapy)
- Virtual pump (open loop for pump which don't have any driver yet - AAPS suggestions only)
## Sensitivity Detection
Select the type of sensitivity detection. For more details of different designs please [read on here](../Configuration/Sensitivity-detection-and-COB.md). This will analyze historical data on the go and make adjustments if it recognizes that you are reacting more sensitively (or conversely, more resistant) to insulin than usual. More details about the Sensitivity algorithm can be read in the [OpenAPS docs](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/autosens.html).
-You can view your sensitivity on the homescreen by selecting SEN and watching the white line. Note, you need to be in [Objective 8](Objectives-objective-8-adjust-basals-and-ratios-if-needed-and-then-enable-autosens) in order to let Sensitivity Detection/[Autosens](Open-APS-features-autosens) automatically adjust the amount of insulin delivered. Before reaching that objective, the Autosens percentage / the line in your graph is displayed for information only.
+You can view your sensitivity on the homescreen by selecting SEN and watching the white line. Note, you need to be in [Objective 8](../Usage/completing-the-objectives.md#objective-8-adjust-basals-and-ratios-if-needed-and-then-enable-autosens) in order to let Sensitivity Detection/[Autosens](../Usage/Open-APS-features.md#autosens) automatically adjust the amount of insulin delivered. Before reaching that objective, the Autosens percentage / the line in your graph is displayed for information only.
(Config-Builder-absorption-settings)=
### Absorption settings
@@ -185,7 +185,7 @@ If you use Oref1 with SMB you must change min_5m_carbimpact to 8. The val
Select the desired APS algorithm for therapy adjustments. You can view the active detail of the chosen algorithm in the OpenAPS(OAPS) tab.
- OpenAPS AMA (advanced meal assist, state of the algorithm in 2017) In simple terms the benefits are after you give yourself a meal bolus the system can high-temp more quickly IF you enter carbs reliably.
- [OpenAPS SMB](../Usage/Open-APS-features.md) (super micro bolus, most recent algorithm for advanced users)
-Note you need to be in [Objective 9](Objectives-objective-9-enabling-additional-oref1-features-for-daytime-use-such-as-super-micro-bolus-smb) in order to use OpenAPS SMB and min_5m_carbimpact must be set to 8 in Config builder > Sensitivity detection > Sensitivity Oref1 settings.
+Note you need to be in [Objective 9](../Usage/completing-the-objectives.md#objective-9-enabling-additional-oref1-features-for-daytime-use-such-as-super-micro-bolus-smb) in order to use OpenAPS SMB and min_5m_carbimpact must be set to 8 in Config builder > Sensitivity detection > Sensitivity Oref1 settings.
## Loop
@@ -203,7 +203,7 @@ Note you need to be in [Objective 9](Objectives-objective-9-enabling-additional-
### Closed Loop
* AAPS continuously evaluates all available data (IOB, COB, BG...) and automatically adjusts the treatment if necessary (i.e. without further intervention by you) to reach the set target range or value (bolus delivery, temporary basal rate, insulin switch-off to avoid hypo etc.).
* The Closed Loop works within numerous safety limits, which you can be set individually.
-* Closed Loop is only possible if you are in [Objective 6](Objectives-objective-6-starting-to-close-the-loop-with-low-glucose-suspend) or higher and use a supported pump.
+* Closed Loop is only possible if you are in [Objective 6](../Usage/completing-the-objectives.md#objective-6-starting-to-close-the-loop-with-low-glucose-suspend) or higher and use a supported pump.
* Please note: In closed loop mode a single target instead of target range (i.e. 5,5 mmol or 100 mg/dl instead of 5,0 - 7,0 mmol or 90 - 125 mg/dl) is recommended.
### Low Glucose Suspend (LGS)
@@ -222,10 +222,10 @@ AAPS has a leraning program (objectives) that you have to fulfill step by step.
You should [export your settings](../Usage/ExportImportSettings.md) (including progress of the objectives) on a regularly basis. In case you have to replace your smartphone later (new purchase, display damage etc.) you can simply import those settings.
-See [Objectives](../Usage/Objectives.md) page for more information.
+See [Objectives](../Usage/completing-the-objectives.md) page for more information.
## Treatments
-If you view the Treatments (Treat) tab, you can see the treatments that have been uploaded to nightscout. Should you wish to edit or delete an entry (e.g. you ate less carbs than you expected) then select 'Remove' and enter the new value (change the time if necessary) through the [carbs button on the home screen](Screenshots-carb-correction).
+If you view the Treatments (Treat) tab, you can see the treatments that have been uploaded to nightscout. Should you wish to edit or delete an entry (e.g. you ate less carbs than you expected) then select 'Remove' and enter the new value (change the time if necessary) through the [carbs button on the home screen](../Getting-Started/Screenshots.md#carb-correction).
## General
### Overview
@@ -272,17 +272,17 @@ Choose wether the tab titles in AAPS are long (e.g. ACTIONS, LOCAL PROFILE, AUTO
Choose if you want to have a notes field when entering treatments or not.
#### Status lights
-Choose if you want to have [status lights](Preferences-status-lights) on overview for cannula age, insulin age, sensor age, battery age, reservoir level or battery level. When warning level is reached, the color of the status light will switch to yellow. Critical age will show up in red.
+Choose if you want to have [status lights](../Configuration/Preferences.md#status-lights) on overview for cannula age, insulin age, sensor age, battery age, reservoir level or battery level. When warning level is reached, the color of the status light will switch to yellow. Critical age will show up in red.
#### Advanced settings
**Deliver this part of bolus wizard result**: When using SMB, many people do not meal-bolus 100% of needed insulin, but only a part of it (e.g. 75 %) and let the SMB with UAM (unattended meal detection) do the rest. In this setting, you can choose a default value for the percenteage the bolus wizard should calculate with. If this setting is 75 % and you had to bolus 10u, the bolus wizard will propose a meal bolus of only 7.5 units.
-**Enable super bolus functionality in wizard** (It is different from *super micro bolus*!): Use with caution and do not enable until you learn what it really does. Basically, the basal for the next two hours is added to the bolus and a two hour zero-temp activated. **AAPS looping functions will be disabled - so use with care! If you use SMB AAPS looping functions will be disabled according to your settings in ["Max minutes of basal to limit SMB to"](Open-APS-features-max-minutes-of-basal-to-limit-smb-to), if you do not use SMB looping functions will be disabled for two hours.** Details on super bolus can be found [here](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus).
+**Enable super bolus functionality in wizard** (It is different from *super micro bolus*!): Use with caution and do not enable until you learn what it really does. Basically, the basal for the next two hours is added to the bolus and a two hour zero-temp activated. **AAPS looping functions will be disabled - so use with care! If you use SMB AAPS looping functions will be disabled according to your settings in ["Max minutes of basal to limit SMB to"](../Usage/Open-APS-features.md#max-minutes-of-basal-to-limit-smb-to), if you do not use SMB looping functions will be disabled for two hours.** Details on super bolus can be found [here](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus).
(Config-Builder-actions)=
### Actions
* Some buttons to quickly access common features.
-* See [AAPS screenshots](Screenshots-action-tab) for details.
+* See [AAPS screenshots](../Getting-Started/Screenshots.md#action-tab) for details.
### Automation
User defined automation tasks ('if-then-else'). Please [read on here](../Usage/Automation.md).
@@ -314,7 +314,7 @@ Display loop information on your xDrip+ watchface (if you are not using AAPS/[AA
### NSClient
* Setup sync of your AAPS data with Nightscout.
-* Settings in [preferences](Preferences-nsclient) can be opened by clicking the cog wheel.
+* Settings in [preferences](../Configuration/Preferences.md#nsclient) can be opened by clicking the cog wheel.
### Maintenance
Email and number of logs to be send. Normally no change necessary.
diff --git a/docs/EN/Configuration/Preferences.md b/docs/EN/Configuration/Preferences.md
index 4d8a5e447a80..e271fb0353ab 100644
--- a/docs/EN/Configuration/Preferences.md
+++ b/docs/EN/Configuration/Preferences.md
@@ -71,7 +71,7 @@
- Custom password should be used if you want to use master password just for securing [exported settings](../Usage/ExportImportSettings.md).
-- If you are using a custom password click on line "Settings password" to set password as described [above](Preferences-master-password).
+- If you are using a custom password click on line "Settings password" to set password as described [above](#master-password).
@@ -169,7 +169,7 @@
### Fill/Prime standard insulin amounts
-- If you want to fill tube or prime cannula through AAPS you can do this through [actions tab](Screenshots-action-tab).
+- If you want to fill tube or prime cannula through AAPS you can do this through [actions tab](../Getting-Started/Screenshots.md#action-tab).
- Pre-set values can be defined in this dialogue.
(Preferences-range-for-visualization)=
@@ -199,7 +199,7 @@
- Status lights give a visual warning for
- Sensor age
- - Sensor battery level for certain smart readers (see [screenshots page](Screenshots-sensor-level-battery) for details).
+ - Sensor battery level for certain smart readers (see [screenshots page](../Getting-Started/Screenshots.md#sensor-level-battery) for details).
- Insulin age (days reservoir is used)
- Reservoir level (units)
- Cannula age
@@ -269,8 +269,8 @@
Depending on your settings in [config builder](../Configuration/Config-Builder.md) you can choose between two algorithms:
-- [Advanced meal assist (OpenAPS AMA)](Open-APS-features-advanced-meal-assist-ama) - state of the algorithm in 2017
-- [Super Micro Bolus (OpenAPS SMB)](Open-APS-features-super-micro-bolus-smb) - most recent algorithm recommended for beginners
+- [Advanced meal assist (OpenAPS AMA)](../Usage/Open-APS-features.md#advanced-meal-assist-ama) - state of the algorithm in 2017
+- [Super Micro Bolus (OpenAPS SMB)](../Usage/Open-APS-features.md#super-micro-bolus-smb) - most recent algorithm recommended for beginners
### OpenAPS AMA settings
@@ -284,7 +284,7 @@ Depending on your settings in [config builder](../Configuration/Config-Builder.m
- The value is measured in units per hour (U/h).
- It is advised to set this to something sensible. A good recommendation is to take the **highest basal rate** in your profile and **multiply it by 4**.
- For example, if the highest basal rate in your profile was 0.5 U/h you could multiply that by 4 to get a value of 2 U/h.
-- See also [detailed feature description](Open-APS-features-max-u-h-a-temp-basal-can-be-set-to-openaps-max-basal).
+- See also [detailed feature description](../Usage/Open-APS-features.md#max-uh-a-temp-basal-can-be-set-to-openaps-max-basal).
#### Maximum basal IOB OpenAPS can deliver \[U\]
@@ -308,7 +308,7 @@ When you feel comfortable, you can allow the system to start giving you addition
#### Autosens
-- [Autosens](Open-APS-features-autosens) looks at blood glucose deviations (positive/negative/neutral).
+- [Autosens](../Usage/Open-APS-features.md#autosens) looks at blood glucose deviations (positive/negative/neutral).
- It will try and figure out how sensitive/resistant you are based on these deviations and adjust basal rate and ISF based on these deviations.
- If you select "Autosens adjust target, too" the algorithm will also modify your glucose target.
@@ -320,17 +320,17 @@ When you feel comfortable, you can allow the system to start giving you addition
(Preferences-openaps-smb-settings)=
### OpenAPS SMB settings
-- In contrast to AMA, [SMB](Open-APS-features-super-micro-bolus-smb) does not use temporary basal rates to control glucose levels, but mainly small super micro boluses.
+- In contrast to AMA, [SMB](../Usage/Open-APS-features.md#super-micro-bolus-smb) does not use temporary basal rates to control glucose levels, but mainly small super micro boluses.
-- You must have started [objective 9](Objectives-objective-9-enabling-additional-oref1-features-for-daytime-use-such-as-super-micro-bolus-smb) to use SMB.
+- You must have started [objective 9](../Usage/completing-the-objectives.md#objective-9-enabling-additional-oref1-features-for-daytime-use-such-as-super-micro-bolus-smb) to use SMB.
-- The first three settings are explained [above](Preferences-max-u-h-a-temp-basal-can-be-set-to).
+- The first three settings are explained [above](#max-uh-a-temp-basal-can-be-set-to).
-- Details on the different enable options are described in [OpenAPS feature section](Open-APS-features-enable-smb).
+- Details on the different enable options are described in [OpenAPS feature section](../Usage/Open-APS-features.md#enable-smb).
- *How frequently SMBs will be given in min* is a restriction for SMB to be delivered only every 4 min by default. This value prevents the system from issuing SMB too often (for example in case of a temp target being set). You should not change this setting unless you know exactly about consequences.
-- If 'Sensitivity raises target' or 'Resistance lowers target' is enabled [Autosens](Open-APS-features-autosens) will modify your glucose target according to your blood glucose deviations.
+- If 'Sensitivity raises target' or 'Resistance lowers target' is enabled [Autosens](../Usage/Open-APS-features.md#autosens) will modify your glucose target according to your blood glucose deviations.
- If target is modified it will be displayed with a green background on your home screen.
@@ -388,18 +388,18 @@ When you feel comfortable, you can allow the system to start giving you addition
### Advanced settings - autosens ratio
-- Define min. and max. [autosens](Open-APS-features-autosens) ratio.
+- Define min. and max. [autosens](../Usage/Open-APS-features.md#autosens) ratio.
- Normally standard values (max. 1.2 and min. 0.7) should not be changed.
## Pump settings
-The options here will vary depending on which pump driver you have selected in [Config Builder](Config-Builder-pump). Pair and set your pump up according to the pump related instructions:
+The options here will vary depending on which pump driver you have selected in [Config Builder](../Configuration/Config-Builder.md#pump). Pair and set your pump up according to the pump related instructions:
-- [DanaR Insulin Pump](../Configuration/DanaR-Insulin-Pump.md)
-- [DanaRS Insulin Pump](../Configuration/DanaRS-Insulin-Pump.md)
-- [Accu Chek Combo Pump](../Configuration/Accu-Chek-Combo-Pump.md)
-- [Accu Chek Insight Pump](../Configuration/Accu-Chek-Insight-Pump.md)
-- [Medtronic Pump](../Configuration/MedtronicPump.md)
+- [DanaR Insulin Pump](../CompatiblePumps/DanaR-Insulin-Pump.md)
+- [DanaRS Insulin Pump](../CompatiblePumps/DanaRS-Insulin-Pump.md)
+- [Accu Chek Combo Pump](../CompatiblePumps/Accu-Chek-Combo-Pump.md)
+- [Accu Chek Insight Pump](../CompatiblePumps/Accu-Chek-Insight-Pump.md)
+- [Medtronic Pump](../CompatiblePumps/MedtronicPump.md)
If using AAPS to open loop then make sure you have selected Virtual Pump in config builder.
@@ -471,7 +471,7 @@ Options in advanced settings are self-explanatory.
## SMS Communicator
-- Options will only be displayed if SMS communicator is selected in [Config Builder](Config-Builder-sms-communicator).
+- Options will only be displayed if SMS communicator is selected in [Config Builder](../Configuration/Config-Builder.md#sms-communicator).
- This setting allows remote control of the app by texting instructions to the patient's phone which the app will follow such as suspending loop, or bolusing.
- Further information is described in [SMS Commands](../Children/SMS-Commands.md).
- Additional safety is obtained through use of an authenticator app and additional PIN at token end.
diff --git a/docs/EN/Getting-Started/CompatiblePumps.md b/docs/EN/Getting-Started/CompatiblePumps.md
new file mode 100644
index 000000000000..d7cd3bb793ad
--- /dev/null
+++ b/docs/EN/Getting-Started/CompatiblePumps.md
@@ -0,0 +1,19 @@
+# Pump choices
+
+AAPS works with a number of insulin pumps. The following list shows the currently supported devices and indicates if AAPS communicates with the pump using your phones native Bluetooth function or if it requires a Rileylink Compatible device in brackets.
+
+- [Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump.md) (Bluetooth; old driver that uses the additional Ruffy app)
+- [Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md) (Bluetooth; new driver, available starting with AndroidAPS v.3.2)
+- [Accu-Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md) (Bluetooth)
+- [DanaR](../CompatiblePumps/DanaR-Insulin-Pump.md) (Bluetooth)
+- [DanaRS](../CompatiblePumps/DanaRS-Insulin-Pump.md) (Bluetooth)
+- [Dana-i](../CompatiblePumps/DanaRS-Insulin-Pump.md) (Bluetooth)
+- [Diaconn G8 ](../CompatiblePumps/DiaconnG8.md) (Bluetooth)
+- [EOPatch2](../CompatiblePumps/EOPatch2.md) (Bluetooth)
+- [Omnipod Eros](../CompatiblePumps/OmnipodEros.md) (Rileylink Compatible Device)
+- [Omnipod DASH](../CompatiblePumps/OmnipodDASH.md) (Bluetooth)
+- [Medtrum Nano](../CompatiblePumps/MedtrumNano.md) (Bluetooth)
+- [Medtrum 300U](../CompatiblePumps/MedtrumNano.md) (Bluetooth)
+- Certain older [Medtronic](../CompatiblePumps/MedtronicPump.md) (Rileylink Compatible Device)
+
+Details of the status of other pumps that may have the potential to work with AAPS are listed on the [Future (possible) Pumps](../CompatiblePumps/Future-possible-Pump-Drivers.md) page.
diff --git a/docs/EN/Getting-Started/CompatiblesCgms.md b/docs/EN/Getting-Started/CompatiblesCgms.md
new file mode 100644
index 000000000000..6657194763fd
--- /dev/null
+++ b/docs/EN/Getting-Started/CompatiblesCgms.md
@@ -0,0 +1,15 @@
+# CGMS/FGMS Configuration
+
+* [General](../CompatibleCgms/GeneralCGMRecommendation.md)
+* [Data Smoothing](../CompatibleCgms/SmoothingBloodGlucoseData.md)
+* [xDrip+Settings](../CompatibleCgms/xDrip.md)
+* [Dexcom G7 and ONE+](../CompatibleCgms/DexcomG7.md)
+* [Dexcom G6 and ONE](../CompatibleCgms/DexcomG6.md)
+* [Dexcom G5](../CompatibleCgms/DexcomG5.md)
+* [Libre 3](../CompatibleCgms/Libre3.md)
+* [Libre 2](../CompatibleCgms/Libre2.md)
+* [Libre 1](../CompatibleCgms/Libre1.md)
+* [Eversense](../CompatibleCgms/Eversense.md)
+* [MM640g/MM630g](../CompatibleCgms/MM640g.md)
+* [PocTech](../CompatibleCgms/PocTech.md)
+* [Nightscout as BG Source](../CompatibleCgms/CgmNightscoutUpload.md)
diff --git a/docs/EN/Getting-Started/FAQ.md b/docs/EN/Getting-Started/FAQ.md
index f7a163a1a440..28d83e6ff77f 100644
--- a/docs/EN/Getting-Started/FAQ.md
+++ b/docs/EN/Getting-Started/FAQ.md
@@ -6,7 +6,7 @@ How to add questions to the FAQ: Follow the these [instructions](../make-a-PR.md
## Can I just download the AAPS installation file?
-No. There is no downloadable apk file for AAPS. You have to [build](../Installing-AndroidAPS/Building-APK.md) it yourself.
+No. There is no downloadable apk file for AAPS. You have to [build](../Installing-AndroidAPS/building-AAPS.md) it yourself.
Here's the reason why:
AAPS is used to control your pump and give insulin. Under current regulations in Europe, all systems classed as IIa or IIb are medical devices that require regulatory approval (a CE mark) which needs various studies and sign offs. Distributing an unregulated device is illegal. Similar regulations exist in other parts of the world.
@@ -19,9 +19,9 @@ That’s why apks aren’t available.
## How to begin?
First of all, you have to **get loopable hardware components**:
-* A [supported insulin pump](./Pump-Choices.md),
-* an [Android smartphone](Phones.md) (Apple iOS is not supported by AAPS - you can check [iOS Loop](https://loopkit.github.io/loopdocs/)) and
-* a [continuous glucose monitoring system](../Configuration/BG-Source.md).
+* A [supported insulin pump](../Getting-Started/CompatiblePumps.md),
+* an [Android smartphone](../CompatiblePhones/ListOfTestedPhones.md) (Apple iOS is not supported by AAPS - you can check [iOS Loop](https://loopkit.github.io/loopdocs/)) and
+* a [continuous glucose monitoring system](../Getting-Started/CompatiblesCgms.md).
Secondly, you have to **setup your hardware**. See [example setup with step-by-step tutorial](Sample-Setup.md).
@@ -41,7 +41,7 @@ If you plan to use the android wear app to bolus or change settings then you nee
### Disconnect pump
If you take your pump off for showering, bathing, swimming, sports or other activities you must let AAPS know that no insulin is delivered to keep IOB correct.
-The pump can be disconnected using the Loop Status icon on the [AAPS Home Screen](Screenshots-loop-status).
+The pump can be disconnected using the Loop Status icon on the [AAPS Home Screen](../Getting-Started/Screenshots.md#loop-status).
### Recommendations not only based on one single CGM reading
For safety, recommendations made are based on not one CGM reading but the average delta. Therefore, if you miss some readings it may take a while after getting data back before AAPS kicks in looping again.
@@ -58,7 +58,7 @@ You have to have the same emergency equipment with you like every other T1D with
* Battery pack and cables to charge your smartphone, watch and (if needed) BT reader or Link device
* Pump batteries
-* Current [apk](../Installing-AndroidAPS/Building-APK.md) and [preferences files](../Usage/ExportImportSettings.md) for AAPS and any other apps you use (e.g. xDrip+, BYO Dexcom) both locally and in the cloud (Dropbox, Google Drive).
+* Current [apk](../Installing-AndroidAPS/building-AAPS.md) and [preferences files](../Usage/ExportImportSettings.md) for AAPS and any other apps you use (e.g. xDrip+, BYO Dexcom) both locally and in the cloud (Dropbox, Google Drive).
## How can I safely and securely attach the CGM/FGM?
You can tape it. There are several pre-perforated 'overpatches' for common CGM systems available (search Google, eBay or Amazon). Some loopers use the cheaper standard kinesiology tape or rocktape.
@@ -211,31 +211,31 @@ Looping can reduce the pump battery faster than normal use because the system in
* Scroll to AAPS and make sure it is de-selected.
* clean battery terminals with alcohol wipe to ensure no manufacturing wax/grease remains.
-* for [Dana R/RS pumps](../Configuration/DanaRS-Insulin-Pump.md) the startup procedure draws a high current across the battery to purposefully break the passivation film (prevents loss of energy whilst in storage) but it doesn't always work to break it 100%. Either remove and reinsert battery 2-3 times until it does show 100% on screen, or use battery key to briefly short circuit battery before insertion by applying to both terminals for a split second.
-* see also more tips for [particular types of battery](Accu-Chek-Combo-Tips-for-Basic-usage-battery-type-and-causes-of-short-battery-life)
+* for [Dana R/RS pumps](../CompatiblePumps/DanaRS-Insulin-Pump.md) the startup procedure draws a high current across the battery to purposefully break the passivation film (prevents loss of energy whilst in storage) but it doesn't always work to break it 100%. Either remove and reinsert battery 2-3 times until it does show 100% on screen, or use battery key to briefly short circuit battery before insertion by applying to both terminals for a split second.
+* see also more tips for [particular types of battery](../Usage/Accu-Chek-Combo-Tips-for-Basic-usage.md#battery-type-and-causes-of-short-battery-life)
### Changing reservoirs and cannulas
The change of cartridge cannot be done via AAPS but must be carried out as before directly via the pump.
* Long press on "Open Loop"/"Closed Loop" on the Home tab of AAPS and select 'Suspend Loop for 1h'
* Now nnect the pump and change the reservoir as per pump instructions.
-* Also priming and filling tube and cannula can be done directly on the pump. In this case use [PRIME/FILL button](CPbefore26-pump) in the actions tab just to record the change.
+* Also priming and filling tube and cannula can be done directly on the pump. In this case use [PRIME/FILL button](../Getting-Started/Screenshots.md#action-tab) in the actions tab just to record the change.
* Once reconnected to the pump continue the loop by long pressing on 'Suspended (X m)'.
-The change of a cannula however does not use the "prime infusion set" function of the pump, but fills the infusion set and/or cannula using a bolus which does not appear in the bolus history. This means it does not interrupt a currently running temporary basal rate. On the Actions (Act) tab, use the [PRIME/FILL button](CPbefore26-pump) to set the amount of insulin needed to fill the infusion set and start the priming. If the amount is not enough, repeat filling. You can set default amount buttons in the Preferences > Other > Fill/Prime standard insulin amounts. See the instruction booklet in your cannula box for how many units should be primed depending on needle length and tubing length.
+The change of a cannula however does not use the "prime infusion set" function of the pump, but fills the infusion set and/or cannula using a bolus which does not appear in the bolus history. This means it does not interrupt a currently running temporary basal rate. On the Actions (Act) tab, use the [PRIME/FILL button](../Getting-Started/Screenshots.md#action-tab) to set the amount of insulin needed to fill the infusion set and start the priming. If the amount is not enough, repeat filling. You can set default amount buttons in the Preferences > Other > Fill/Prime standard insulin amounts. See the instruction booklet in your cannula box for how many units should be primed depending on needle length and tubing length.
## Wallpaper
-You can find the AAPS wallpaper for your phone on the [phones page](Phones-phone-background).
+You can find the AAPS wallpaper for your phone on the [phones page](../CompatiblePhones/ListOfTestedPhones.md#phone-background).
## Daily usage
### Hygiene
#### What to do when taking a shower or bath?
-You can remove the pump while taking a shower or bath. For this short period of time you may not need it, but you should tell AAPS that you've disconnected so that the IOB calculations are correct. See [description above](FAQ-disconnect-pump).
+You can remove the pump while taking a shower or bath. For this short period of time you may not need it, but you should tell AAPS that you've disconnected so that the IOB calculations are correct. See [description above](../Getting-Started/FAQ.md#disconnect-pump).
### Work
-Depending on your job, you may choose to use different treatment factors on workdays. As a looper you should consider a [profile switch](../Usage/Profiles.md) for your typical working day. For example, you may switch to a profile higher than 100% if you have a less demanding job (e.g. sitting at a desk), or less than 100% if you are active and on your feet all day. You could also consider a high or low temporary target or a [time shift of your profile](Profiles-time-shift) when working much earlier or later than regular, of if you work different shifts. You can also create a second profile (e.g. 'home' and 'workday') and do a daily profile switch to the profile you actually need.
+Depending on your job, you may choose to use different treatment factors on workdays. As a looper you should consider a [profile switch](../Usage/Profiles.md) for your typical working day. For example, you may switch to a profile higher than 100% if you have a less demanding job (e.g. sitting at a desk), or less than 100% if you are active and on your feet all day. You could also consider a high or low temporary target or a [time shift of your profile](../Usage/Profiles.md#time-shift-of-the-circadian-percentage-profile) when working much earlier or later than regular, of if you work different shifts. You can also create a second profile (e.g. 'home' and 'workday') and do a daily profile switch to the profile you actually need.
## Leisure activities
@@ -247,8 +247,8 @@ So, you would have more carbohydrates on board, but at the same time the loop wo
When looping you should try these steps:
* Make a [profile switch](../Usage/Profiles.md) < 100%.
-* Set an [activity temp target](temptarget-activity-temp-target) above your standard target.
-* If you are using SMB make sure ["Enable SMB with high temp targets"](Open-APS-features-enable-smb-with-high-temp-targets) and ["Enable SMB always"](Open-APS-features#enable-smb-always) are disabled.
+* Set an [activity temp target](../Usage/temptarget.md#activity-temp-target) above your standard target.
+* If you are using SMB make sure ["Enable SMB with high temp targets"](../Usage/Open-APS-features.md#enable-smb-with-high-temp-targets) and ["Enable SMB always"](../Usage/Open-APS-features.md#enable-smb-always) are disabled.
Pre- and post-processing of these settings is important. Make the changes in time before sport and consider the effect of muscle filling.
@@ -257,7 +257,7 @@ If you do sports regularly at the same time (i.e. sports class in your gym) you
The percentage of the profile switch, the value for your activity temp target and best time for the changes are individual. Start on the safe side if you are looking for the right value for you (start with lower percentage and higher TT).
### Sex
-You can remove the pump to be 'free', but you should tell AAPS so that the IOB calculations are correct. See [description above](FAQ-disconnect-pump).
+You can remove the pump to be 'free', but you should tell AAPS so that the IOB calculations are correct. See [description above](#disconnect-pump).
### Drinking alcohol
Drinking alcohol is risky in closed loop mode as the algorithm cannot predict the alcohol influenced BG correctly. You have to check out your own method for treating this using the following functions in AAPS:
@@ -271,7 +271,7 @@ When drinking alcohol, you always have to have an eye on your CGM to manually av
### Sleeping
#### How can I loop during the night without mobile and WIFI radiation?
-Many users turn the phone into airplane mode at night. If you want the loop to support you when you are sleeping, proceed as follows (this will only work with a local BG-source such as xDrip+ or ['Build your own Dexcom App'](DexcomG6-if-using-g6-with-build-your-own-dexcom-app), it will NOT work if you get the BG-readings via Nightscout):
+Many users turn the phone into airplane mode at night. If you want the loop to support you when you are sleeping, proceed as follows (this will only work with a local BG-source such as xDrip+ or ['Build your own Dexcom App'](../CompatibleCgms/DexcomG6.md#if-using-g6-with-build-your-own-dexcom-app), it will NOT work if you get the BG-readings via Nightscout):
1. Turn on airplane mode in your mobile.
2. Wait until the airplane mode is active.
@@ -304,11 +304,11 @@ You can either show your Nightscout reports (https://YOUR-NS-SITE.com/report) or
## My problem is not listed here.
-[Information to get help.](Connect-with-other-users-i-m-getting-stuck-what-do-i-do-who-can-i-ask)
+[Information to get help.](../Where-To-Go-For-Help/Connect-with-other-users.md#im-getting-stuck-what-do-i-do-who-can-i-ask)
## My problem is not listed here but I found the solution
-[Information to get help.](Connect-with-other-users-i-m-getting-stuck-what-do-i-do-who-can-i-ask)
+[Information to get help.](../Where-To-Go-For-Help/Connect-with-other-users.md#im-getting-stuck-what-do-i-do-who-can-i-ask)
**Remind us to add your solution to this list!**
@@ -328,7 +328,7 @@ Copy on an internet drive (Dropbox, Google etc) : all the apks you used to insta
Please
-* check [Troubleshooting Android Studio](troubleshooting_androidstudio-troubleshooting-android-studio) for typical errors and
+* check [Troubleshooting Android Studio](../Installing-AndroidAPS/troubleshooting_androidstudio.md) for typical errors and
* the tipps for with a [step by step walktrough](https://docs.google.com/document/d/1oc7aG0qrIMvK57unMqPEOoLt-J8UT1mxTKdTAxm8-po).
## I'm stuck on an objective and need help.
@@ -341,7 +341,7 @@ Open the hamburger menu, start the Configuration wizard and enter new password w
## How to reset the password in AAPS v3.x
-You find the documentation [here](update3_0-reset-master-password).
+You find the documentation [here](../Installing-AndroidAPS/update3_0.md#reset-master-password).
## My link/pump/pod is unresponsive (RL/OL/EmaLink…)
diff --git a/docs/EN/Getting-Started/Introduction.md b/docs/EN/Getting-Started/Introduction.md
index 55cf8c09f4ce..52cbc523b591 100644
--- a/docs/EN/Getting-Started/Introduction.md
+++ b/docs/EN/Getting-Started/Introduction.md
@@ -125,29 +125,29 @@ As of June 25 2023, there are four major open source closed loop systems availab
| Phone | Android |  |  |  |  |
| Phone | iPhone |  |  |  |  |
| Rig | tiny computer (1) |  |  |  |  |
-| PUMP | [Dana I](../Configuration/DanaRS-Insulin-Pump.md) |  |  |  |  |
-| PUMP | [Dana RS](../Configuration/DanaRS-Insulin-Pump.md) |  |  |  |  |
-| PUMP | [Dana R](../Configuration/DanaR-Insulin-Pump.md) |  |  |  |  |
-| PUMP | [Omnipod (Dash)](../Configuration/OmnipodDASH.md) (2) |  |  |  |  |
-| PUMP | [Omnipod (Eros)](../Configuration/OmnipodEros.md) |  |  |  |  |
-| PUMP | [Diaconn G8](../Configuration/DiaconnG8.md) |  |  |  |  |
-| PUMP | [EOPatch 2](../Configuration/EOPatch2.md) |  |  |  |  |
-| PUMP | [Medtrum TouchCare Nano](../Configuration/MedtrumNano.md) |  |  |  |  |
-| PUMP | [Medtrum TouchCare 300U](../Configuration/MedtrumNano.md) |  |  |  |  |
-| PUMP | [Roche Combo](../Configuration/Accu-Chek-Combo-Pump.md) |  |  |  |  |
-| PUMP | [Roche Insight](../Configuration/Accu-Chek-Insight-Pump.md) |  |  |  |  |
-| PUMP | [Older Medtronic](../Configuration/MedtronicPump.md) |  |  |  |  |
-| CGM | [Dexcom G7](../Hardware/DexcomG7.md) |  |  |  |  |
-| CGM | [Dexcom One](../Hardware/DexcomG6.md) |  |  |  |  |
-| CGM | [Dexcom G6](../Hardware/DexcomG6.md) |  |  |  |  |
-| CGM | [Dexcom G5](../Hardware/DexcomG5.md) |  |  |  |  |
-| CGM | [Libre 3](../Hardware/Libre3.md) |  |  |  |  |
-| CGM | [Libre 2](../Hardware/Libre2.md) |  |  |  |  |
-| CGM | [Libre 1](../Hardware/Libre1.md) |  |  |  |  |
-| CGM | [Eversense](../Hardware/Eversense.md) |  |  |  |  |
-| CGM | [MM640g/MM630g](../Hardware/MM640g.md) |  |  |  |  |
-| CGM | [PocTech](../Hardware/PocTech.md) |  |  |  |  |
-| CGM | [Nightscout as BG Source](../Hardware/CgmNightscoutUpload.md) |  |  |  |  |
+| PUMP | [Dana I](../CompatiblePumps/DanaRS-Insulin-Pump.md) |  |  |  |  |
+| PUMP | [Dana RS](../CompatiblePumps/DanaRS-Insulin-Pump.md) |  |  |  |  |
+| PUMP | [Dana R](../CompatiblePumps/DanaR-Insulin-Pump.md) |  |  |  |  |
+| PUMP | [Omnipod (Dash)](../CompatiblePumps/OmnipodDASH.md) (2) |  |  |  |  |
+| PUMP | [Omnipod (Eros)](../CompatiblePumps/OmnipodEros.md) |  |  |  |  |
+| PUMP | [Diaconn G8](../CompatiblePumps/DiaconnG8.md) |  |  |  |  |
+| PUMP | [EOPatch 2](../CompatiblePumps/EOPatch2.md) |  |  |  |  |
+| PUMP | [Medtrum TouchCare Nano](../CompatiblePumps/MedtrumNano.md) |  |  |  |  |
+| PUMP | [Medtrum TouchCare 300U](../CompatiblePumps/MedtrumNano.md) |  |  |  |  |
+| PUMP | [Roche Combo](../CompatiblePumps/Accu-Chek-Combo-Pump.md) |  |  |  |  |
+| PUMP | [Roche Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md) |  |  |  |  |
+| PUMP | [Older Medtronic](../CompatiblePumps/MedtronicPump.md) |  |  |  |  |
+| CGM | [Dexcom G7](../CompatibleCgms/DexcomG7.md) |  |  |  |  |
+| CGM | [Dexcom One](../CompatibleCgms/DexcomG6.md) |  |  |  |  |
+| CGM | [Dexcom G6](../CompatibleCgms/DexcomG6.md) |  |  |  |  |
+| CGM | [Dexcom G5](../CompatibleCgms/DexcomG5.md) |  |  |  |  |
+| CGM | [Libre 3](../CompatibleCgms/Libre3.md) |  |  |  |  |
+| CGM | [Libre 2](../CompatibleCgms/Libre2.md) |  |  |  |  |
+| CGM | [Libre 1](../CompatibleCgms/Libre1.md) |  |  |  |  |
+| CGM | [Eversense](../CompatibleCgms/Eversense.md) |  |  |  |  |
+| CGM | [MM640g/MM630g](../CompatibleCgms/MM640g.md) |  |  |  |  |
+| CGM | [PocTech](../CompatibleCgms/PocTech.md) |  |  |  |  |
+| CGM | [Nightscout as BG Source](../CompatibleCgms/CgmNightscoutUpload.md) |  |  |  |  |
_Table notes:_
1. A **rig** is a small computer which you carry around with you, without a monitor. One supported device type is Intel Edison + Explorer Board and the other Raspberry Pi + Explorer HAT or Adafruit RFM69HCW Bonnet. The first APS were based on this setup, as mobile phones were not capable of running the required algorithms. Use of these systems has declined, as the setup on mobile phones has become easier, and phones have a display included. Intel has also stopped selling the Intel Edison. The excellent OpenAPS algorithms **oref0** and **oref1** are now incorporated in AAPS and iAPS.
@@ -188,7 +188,7 @@ If a malicious attack was made on your insulin pump, these strategies would sign
#### Safety considerations around improving blood glucose control too fast
-A rapid reduction in HbA1c and improved blood glucose control sounds appealing. However, reducing average blood glucose levels _too fast_ by starting any closed loop system can cause permanent damage, including to the eyes, and painful neuropathy that never goes away. This damage can be avoided simply by reducing levels more slowly. If you currently have an elevated HbA1c and are moving to AAPS (or any other closed loop system), please discuss this potential risk with your clinical team before starting, and agree a timeplan with them. More general information on how to reduce your glucose levels safely, including links to medical literature is given in the [safety section [here](../preparing.md#safety-first).
+A rapid reduction in HbA1c and improved blood glucose control sounds appealing. However, reducing average blood glucose levels _too fast_ by starting any closed loop system can cause permanent damage, including to the eyes, and painful neuropathy that never goes away. This damage can be avoided simply by reducing levels more slowly. If you currently have an elevated HbA1c and are moving to AAPS (or any other closed loop system), please discuss this potential risk with your clinical team before starting, and agree a timeplan with them. More general information on how to reduce your glucose levels safely, including links to medical literature is given in the [safety section [here](../Getting-Started/PreparingForAaps.md#safety-first).
#### Medical safety around devices, consumable supplies and other medications
@@ -196,7 +196,7 @@ Use a tested, fully functioning FDA or CE approved insulin pump and CGM for an a
Use original supplies such as inserters, cannulas and insulin containers approved by the manufacturer of your pump and CGM. Using untested or modified supplies can cause CGM inaccuracy and insulin dosing errors. Insulin is highly dangerous when misdosed - please do not play with your life by hacking your supplies.
-Do not take SGLT-2 inhibitors (gliflozins) when using **AAPS** as they incalculably lower blood sugar levels. Combining this effect with a system that lowers basal rates in order to increase BG is dangerous, there is more detail about this in the main [safety section](../preparing.md#safety-first).
+Do not take SGLT-2 inhibitors (gliflozins) when using **AAPS** as they incalculably lower blood sugar levels. Combining this effect with a system that lowers basal rates in order to increase BG is dangerous, there is more detail about this in the main [safety section](../Getting-Started/PreparingForAaps.md#safety-first).
(introduction-how-can-i-approach-discussing-aaps-with-my-clinical-team)=
## How can I approach discussing AAPS with my clinical team?
@@ -378,4 +378,4 @@ With investment of your time, **AAPS** can potentially lead to:
Ultimately, **AAPS** can empower individuals to better manage their diabetes, resulting in stable blood sugars and improved long term health outcomes.
-Interested in how to get started with setting up AAPS? Take a look at the [preparing](../preparing.md) section.
+Interested in how to get started with setting up AAPS? Take a look at the [preparing](../Getting-Started/PreparingForAaps.md) section.
diff --git a/docs/EN/Getting-Started/Phones.md b/docs/EN/Getting-Started/Phones.md
index 3b30b6cd0fa2..c2737bd73b5f 100644
--- a/docs/EN/Getting-Started/Phones.md
+++ b/docs/EN/Getting-Started/Phones.md
@@ -1,27 +1,5 @@
-(Phones-list-of-tested-phones)=
-# List of tested Phones compatible with Omnipod Dash Insulin Pump Pods
+# Phones
-Currently, we have a very hard-working behind-the-scenes Maintainer, who is in charge of ensuring the integrity of the Hardware List of all Android Phones/Smartwatches Capable of Looping with the Omnipod Dash; the newest pump driver addition to our ever-expanding network of Bluetooth enabled insulin pumps for use within the AAPS/OpenAPS ecosystem!
-
-Our Maintainer has spent a lot of time and effort to make sure that its easy for everyone to enter data into the Spreadsheet; via a Google Form with pre-populated information headers for ease of use! This ensures that the existing data on the sheets cannot be accidentally overwritten or deleted. The same experience can be built upon the success of the first again using Google Sheets.
-
-Thanks to the ease of Google Spreadsheets, close communication amongst early adopters and the ability of pooling their collective knowledge and lessons learned throughout early testing/feedback phases of the Dash pump pod drivers was compiled quite efficiently. The results of the time, information and energy provided by the numerous Early Adopters in providing step-by-step feedback on each new version of the Dash Bluetooth drivers becomes apparent once you open the up what is now a comprehensive Compare/Contrast list of all hardware suited for Looping with the Omnipod Dash, with many Android Phones and Smartwatches tested and ranked for compatibility. In addition, the more incompatible setups are also included in this Spreadshee so that new users will know which hardware to avoid due to issues with connection speed or strength.
-
-When the time comes for another Hardware Compatibility List to be created in the future; we encourage anyone that feels they might enjoy becoming a Maintainer to please contact us!
-
-The list of the tested phone can be accessed via the following link [list of tested phones with Omnipod insulin pump](https://docs.google.com/spreadsheets/d/1zO-Vf3wv0jji5Gflk6pe48oi348ApF5RvMcI6NG5TnY)
-
-With CRTL-F you can search in the text of the Google sheet. The sheet is write protected. To record your test of a phone please fill in the [form](https://forms.gle/g7GbSkMCTfFrWKjSA).
-
-After you fill in the form data the maintainer will check the data and approve it for publishing!
-
-Any problems with the spreadsheet please contact us directly or via a GitHub issue for the openaps/AndroidAPSDocs project.
-
-(Phones-phone-background)=
-# Phone Background
-
-
-
-Design: Thiago :)
-
-If you want to decorate your phone with more AAPS, you can download your background image here: 
+- [List of tested phones](../CompatiblePhones/ListOfTestedPhones.md)
+- [Jelly Pro Settings](../CompatiblePhones/Jelly.md)
+- [Huawei Settings](../CompatiblePhones/Huawei.md)
diff --git a/docs/EN/preparing.md b/docs/EN/Getting-Started/PreparingForAaps.md
similarity index 86%
rename from docs/EN/preparing.md
rename to docs/EN/Getting-Started/PreparingForAaps.md
index 3c8e72206b80..ce82b0af2d49 100644
--- a/docs/EN/preparing.md
+++ b/docs/EN/Getting-Started/PreparingForAaps.md
@@ -4,7 +4,7 @@ Welcome. This documentation aims to guide users who are preparing to setup and s
## Finding your way around the documentation
-An **index** and explanation of the documentation structure can be found [here](index.md), you can also reach it by clicking on the **AAPS** symbol at the top left of the documentation. There you will find an overview of the purpose of the different documentation sections. You can also use the headings to the left of this page to navigate through the documentation. Finally, there is a handy search function, directly below the **AAPS** symbol.
+An **index** and explanation of the documentation structure can be found [here](../index.md), you can also reach it by clicking on the **AAPS** symbol at the top left of the documentation. There you will find an overview of the purpose of the different documentation sections. You can also use the headings to the left of this page to navigate through the documentation. Finally, there is a handy search function, directly below the **AAPS** symbol.
We aim to make it easy to determine both the capabilities and limitations of **AAPS**. It can be disappointing to discover after investing time in reading the documentation that you might not have a compatible insulin pump or CGM, or that **AAPS** offers different functionality than hoped for.
@@ -16,9 +16,9 @@ Many experience-related details in the **AAPS** documentation make more sense wh
“With great power comes great responsibility…”
### Technical safety
-**AAPS** has an extensive set of safety features. These impose constraints which are gradually removed through staged completion of a series of [Objectives](Usage/completing-the-objectives.md) which involve testing specific parameters and answering multiple choice questions. **AAPS** features are unlocked as the Objectives are successfully completed. This process allows the user to migrate safely in stages from Open Loop to Closed Loop, while learning about the different features of **AAPS**.
+**AAPS** has an extensive set of safety features. These impose constraints which are gradually removed through staged completion of a series of [Objectives](../Usage/completing-the-objectives.md) which involve testing specific parameters and answering multiple choice questions. **AAPS** features are unlocked as the Objectives are successfully completed. This process allows the user to migrate safely in stages from Open Loop to Closed Loop, while learning about the different features of **AAPS**.
-The [Objectives](Usage/completing-the-objectives.md) have been designed to achieve the best possible introduction to **AAPS**, taking into consideration the typical errors and general trends **AAPS** developers have observed with new users. Mistakes can happen because the beginner is inexperienced and too eager to get started with **AAPS**, or has overlooked key points. The [Objectives](Usage/completing-the-objectives.md) aim to minimise these issues.
+The [Objectives](../Usage/completing-the-objectives.md) have been designed to achieve the best possible introduction to **AAPS**, taking into consideration the typical errors and general trends **AAPS** developers have observed with new users. Mistakes can happen because the beginner is inexperienced and too eager to get started with **AAPS**, or has overlooked key points. The [Objectives](../Usage/completing-the-objectives.md) aim to minimise these issues.
### Medical safety
```{admonition} Avoid permanent and painful damage to your eyes and nerves
@@ -75,7 +75,7 @@ In the preliminary stages of getting started with **AAPS**, you may experience d
#### Technology compatibility
-**AAPS** is only compatible with certain types of insulin pumps, CGMs and phones, and some technology may not be available for use in various countries. In order to avoid any disappointment or frustrations, please read the [CGM](Configuration/BG-Source.md), [pump](Getting-Started/Pump-Choices.md) and [phone](Hardware/Phoneconfig.md) sections.
+**AAPS** is only compatible with certain types of insulin pumps, CGMs and phones, and some technology may not be available for use in various countries. In order to avoid any disappointment or frustrations, please read the [CGM](../Getting-Started/CompatiblesCgms.md), [pump](../Getting-Started/CompatiblePumps.md) and [phone](../Getting-Started/Phones.md) sections.
#### App build time and progressing to full looping
@@ -83,9 +83,9 @@ The time to build the **AAPS** app depends on your level of expertise and techn
To aid the build process there are dedicated sections:
-- List of questions and answers for frequent errors that are likely to occur in [FAQs (Section](Getting-Started/FAQ.md) K);
+- List of questions and answers for frequent errors that are likely to occur in [FAQs (Section](../Getting-Started/FAQ.md) K);
-- “[How to install AAPS](Installing-AndroidAPS/building-AAPS.md)? (Section D) which includes [Troubleshooting](Usage/troubleshooting.md) Subsection.
+- “[How to install AAPS](../Installing-AndroidAPS/building-AAPS.md)? (Section D) which includes [Troubleshooting](../Usage/troubleshooting.md) Subsection.
How long it takes to get to closed looping depends on the individual, but an approximate timescale for getting to full looping with AAPS can be found ([here](#how-long-will-it-take-to-set-everything-up))
@@ -101,7 +101,7 @@ A “keystore” (.jks file) is a password encrypted file unique to your own cop
This will ensure that you can use that exact same keystore file each time an updated version of **AAPS** is created. On average, there will be 2 **AAPS** updates required each year.
-In addition, **AAPS** provides the ability to [export all your configuration settings](Usage/ExportImportSettings.md). This ensures that you can safely recover your system while changing phones, upgrading/reinstalling the application with minimum disruption.
+In addition, **AAPS** provides the ability to [export all your configuration settings](../Usage/ExportImportSettings.md). This ensures that you can safely recover your system while changing phones, upgrading/reinstalling the application with minimum disruption.
#### Troubleshooting
@@ -115,19 +115,19 @@ Please feel free to reach out to the AAPS community if there is anything you fee
-#### [Where to go for help](Where-To-Go-For-Help/Background-reading.md)?
+#### [Where to go for help](../Where-To-Go-For-Help/Background-reading.md)?
This section is aimed to provide new users with links on resources in order to get help including accessing community support made up of both new and experienced users who can clarify questions, and resolve the usual pitfalls that come with AAPS.
-#### [Section For Clinicians](Resources/clinician-guide-to-AndroidAPS.md)
+#### [Section For Clinicians](../Resources/clinician-guide-to-AndroidAPS.md)
-This is a [section specificially for clinicians](Resources/clinician-guide-to-AndroidAPS.md) who want to know more about AAPS and open source artificial pancreas technology. There is also guidance on [how to talk to your clinical team](introduction-how-can-i-approach-discussing-aaps-with-my-clinical-team) in the Introduction.
+This is a [section specificially for clinicians](../Resources/clinician-guide-to-AndroidAPS.md) who want to know more about AAPS and open source artificial pancreas technology. There is also guidance on [how to talk to your clinical team](./Introduction.md#how-can-i-approach-discussing-aaps-with-my-clinical-team) in the Introduction.
## What are we going to build and install?
This diagram provides an overview of the key components (both hardware and software) of the **AAPS** system:
-
+
In addition to the three basic hardware components (phone, pump, glucose sensor), we also need:
@@ -146,11 +146,11 @@ Attempting to analyse your diabetes performance by looking at CGM data separatel
### 3) CGM sensor app
-Depending on your glucose sensor/CGM, you will need a compatible app for receiving glucose readings and sending them to **AAPS**. The different options are shown below and more information is given in the [compatible CGMs section](./Configuration/BG-Source.md):
+Depending on your glucose sensor/CGM, you will need a compatible app for receiving glucose readings and sending them to **AAPS**. The different options are shown below and more information is given in the [compatible CGMs section](../Getting-Started/CompatiblesCgms.md):
-
-
-
+
+
+
### Maintenance of the **AAPS** system
@@ -193,7 +193,7 @@ Once you are fully operational on **AAPS**, you will still need to regularly fin
### Medical considerations
-In addition to the medical warnings in the [safety section](preparing-safety-first) there are also different parameters, depending on which insulin you are using in the pump.
+In addition to the medical warnings in the [safety section](#safety-first) there are also different parameters, depending on which insulin you are using in the pump.
#### Insulin choice
@@ -221,9 +221,9 @@ The exact model you buy depends on the desired function(s). There are two archiv
To make a donation of smartphone or smartwatch models that still need testing, please email [donations@androidaps.org](mailto:donations@androidaps.org).
-- [List of tested phones](Getting-Started/Phones.md)
-- [Jelly Settings](Usage/jelly.md)
-- [Huawei Settings](Usage/huawei.md)
+- [List of tested phones](../CompatiblePhones/ListOfTestedPhones.md)
+- [Jelly Settings](../CompatiblePhones/Jelly.md)
+- [Huawei Settings](../CompatiblePhones/Huawei.md)
Users are encouraged to keep their phone Android version up-to-date, including with security parameters. However, if you are new with **AAPS** or are not a technical expert you might want to delay updating your phone until others have done so and confirmed it is safe to do so, on our various forums.
diff --git a/docs/EN/Getting-Started/Pump-Choices.md b/docs/EN/Getting-Started/Pump-Choices.md
deleted file mode 100644
index 1198b40b5ee4..000000000000
--- a/docs/EN/Getting-Started/Pump-Choices.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Pump choices
-
-AAPS works with a number of insulin pumps. The following list shows the currently supported devices and indicates if AAPS communicates with the pump using your phones native Bluetooth function or if it requires a Rileylink Compatible device in brackets.
-
-- [Accu-Chek Combo](../Configuration/Accu-Chek-Combo-Pump.md) (Bluetooth; old driver that uses the additional Ruffy app)
-- [Accu-Chek Combo](../Configuration/Accu-Chek-Combo-Pump-v2.md) (Bluetooth; new driver, available starting with AndroidAPS v.3.2)
-- [Accu-Chek Insight](../Configuration/Accu-Chek-Insight-Pump.md) (Bluetooth)
-- [DanaR](../Configuration/DanaR-Insulin-Pump.md) (Bluetooth)
-- [DanaRS](../Configuration/DanaRS-Insulin-Pump.md) (Bluetooth)
-- [Dana-i](../Configuration/DanaRS-Insulin-Pump.md) (Bluetooth)
-- [Diaconn G8 ](../Configuration/DiaconnG8.md) (Bluetooth)
-- [EOPatch2](../Configuration/EOPatch2.md) (Bluetooth)
-- [Omnipod Eros](../Configuration/OmnipodEros.md) (Rileylink Compatible Device)
-- [Omnipod DASH](../Configuration/OmnipodDASH.md) (Bluetooth)
-- [Medtrum Nano](../Configuration/MedtrumNano.md) (Bluetooth)
-- [Medtrum 300U](../Configuration/MedtrumNano.md) (Bluetooth)
-- Certain older [Medtronic](../Configuration/MedtronicPump.md) (Rileylink Compatible Device)
-
-Details of the status of other pumps that may have the potential to work with AAPS are listed on the [Future (possible) Pumps](Future-possible-Pump-Drivers.md) page.
diff --git a/docs/EN/Getting-Started/Screenshots.md b/docs/EN/Getting-Started/Screenshots.md
index fbea84486938..818db5f3286f 100644
--- a/docs/EN/Getting-Started/Screenshots.md
+++ b/docs/EN/Getting-Started/Screenshots.md
@@ -9,9 +9,8 @@ This is the first screen you will come across when you open AAPS and it contains
### Section A - Tabs
* Navigate between the various AAPS modules.
* Alternatively you can change screens by swiping left or right.
-* Displayed tabs can be selected in [config builder](Config-Builder-tab-or-hamburger-menu).
+* Displayed tabs can be selected in [config builder](../Configuration/Config-Builder.md#tab-or-hamburger-menu).
-(Screenshots-section-b-profile-target)=
### Section B - Profile & target
#### Current Profile
@@ -20,7 +19,7 @@ This is the first screen you will come across when you open AAPS and it contains
* Current profile is displayed in the left bar.
* Short press profile bar to view profile details
-* Long press profile bar to [switch between different profiles](Profiles-profile-switch).
+* Long press profile bar to [switch between different profiles](../Usage/Profiles.md#profile-switch--profile-percentage).
* If profile switch was made with duration remaining time in minutes is shown in brackets.
#### Target
@@ -31,14 +30,12 @@ This is the first screen you will come across when you open AAPS and it contains
* Short press target bar to set a [temporary target](../Usage/temptarget.md).
* If temp target is set bar turns yellow and remaining time in minutes is shown in brackets.
-
-(Screenshots-visualization-of-dynamic-target-adjustment)=
#### Visualization of Dynamic target adjustment
* AAPS can dynamically adjust your target based on sensitivity if you are using SMB algorithm.
-* Enable either one or both of the [following options](Preferences-openaps-smb-settings)
+* Enable either one or both of the [following options](../Configuration/Preferences.md#openaps-smb-settings)
* "sensitivity raises target" and/or
* "resistance lowers target"
* If AAPS detects resistance or sensitivity the target will change from what is set from profile.
@@ -48,20 +45,19 @@ This is the first screen you will come across when you open AAPS and it contains
#### Current blood glucose
* Latest blood glucose reading from your CGM is shown on the left side.
-* Color of the BG value reflects the status to the defined [range](Preferences-range-for-visualization).
+* Color of the BG value reflects the status to the defined [range](../Configuration/Preferences.md#range-for-visualization).
* green = in range
* red = below range
* yellow = above range
* The greyish block in the middle shows minutes since last reading and changes since last reading, in the last 15 and 40 minutes.
-(Screenshots-loop-status)=
#### Loop status
* A new icon shows loop status:
* green circle = loop running
- * green circle with dotted line = [low glucose suspend (LGS)](Objectives-objective-6-starting-to-close-the-loop-with-low-glucose-suspend)
+ * green circle with dotted line = [low glucose suspend (LGS)](../Usage/completing-the-objectives.md#objective-6-starting-to-close-the-loop-with-low-glucose-suspend)
* red circled = loop disabled (not working permanently)
* yellow circle = loop suspended (temporarily paused but basal insulin will be given) - remaining time is shown below icon
* grey circle = pump disconnected (temporarily no insulin dosage at all) - remaining time is shown below icon
@@ -74,7 +70,6 @@ This is the first screen you will come across when you open AAPS and it contains
-(Screenshots-bg-warning-sign)=
#### BG warning sign
Beginning with Android 3.0, you might get a warning signal beneath your BG number on the main screen.
@@ -128,7 +123,7 @@ You need to find out why you get duplicate BGs:
-> icon pulses if carbs are required
* Purple line: basal rate - icon changes reflecting temporary changes in basal rate (flat at 100%)
* Press the icon to see the base basal rate and details of any temp basal (including remaining duration)
-* Arrows up & down: indicating actual [autosens](Open-APS-features-autosens) status (enabled or disabled) and value is shown below icon
+* Arrows up & down: indicating actual [autosens](../Usage/Open-APS-features.md#autosens) status (enabled or disabled) and value is shown below icon
#### Carbs required
@@ -149,9 +144,8 @@ You need to find out why you get duplicate BGs:
* Battery age and level (%)
* If threshold warning is exceeded, values will be shown in yellow.
* If threshold critical is exceeded, values will be shown in red.
-* Settings can be made in [preferences](Preferences-status-lights).
+* Settings can be made in [preferences](../Configuration/Preferences.md#status-lights).
-(Screenshots-section-f-main-graph)=
### Section F - Main graph
@@ -159,8 +153,8 @@ You need to find out why you get duplicate BGs:
* Graph shows your blood glucose (BG) as read from your glucose monitor (CGM).
* Notes entered in action tab such as fingerstick calibrations and carbs entries as well as profile switches are shown here.
* Long press on the graph to change the time scale. You can choose 6, 12, 18 or 24 hours.
-* The green area reflects your target range. It can be configured in [preferences](Preferences-range-for-visualization).
-* Blue triangles show [SMB](Open-APS-features-super-micro-bolus-smb) - if enabled in [preferences](Preferences-openaps-smb-settings).
+* The green area reflects your target range. It can be configured in [preferences](../Configuration/Preferences.md#range-for-visualization).
+* Blue triangles show [SMB](../Usage/Open-APS-features.md#super-micro-bolus-smb) - if enabled in [preferences](../Configuration/Preferences.md#openaps-smb-settings).
* Optional information:
* Predictions
@@ -190,20 +184,19 @@ You need to find out why you get duplicate BGs:
Prediction line shows how the BG trajectory line would change if the pump stopped all insulin delivery (0% TBR).
- *This line appears only when the [SMB](Preferences-advanced-meal-assist-ama-or-super-micro-bolus-smb) algorithm is used.*
-
+ *This line appears only when the [SMB](../Configuration/Preferences.md#advanced-meal-assist-ama-or-super-micro-bolus-smb) algorithm is used.*
-* **Dark yellow** line: [UAM](Sensitivity-detection-and-COB-sensitivity-oref1) (un-announced meals)
+* **Dark yellow** line: [UAM](../Configuration/Sensitivity-detection-and-COB.md#sensitivity-oref1) (un-announced meals)
Unannounced meals means that a significant increase in glucose levels due to meals, adrenaline or other influences is detected. Prediction line is similar to the ORANGE COB line but it assumes that the deviations will taper down at a constant rate (by extending the current rate of reduction).
- *This line appears only when the [SMB](Preferences-advanced-meal-assist-ama-or-super-micro-bolus-smb) algorithm is used.*
+ *This line appears only when the [SMB](../Configuration/Preferences.md#advanced-meal-assist-ama-or-super-micro-bolus-smb) algorithm is used.*
* **Dark orange** line: aCOB (accelerated carbohydrate absorption)
Similar to COB, but assuming a static 10 mg/dL/5m (-0.555 mmol/l/5m) carb absorption rate. Deprecated and of limited usefulness.
- *This line appears only when the older [AMA](Preferences-advanced-meal-assist-ama-or-super-micro-bolus-smb) algorithm is used.*
+ *This line appears only when the older [AMA](../Configuration/Preferences.md#advanced-meal-assist-ama-or-super-micro-bolus-smb) algorithm is used.*
Usually your real glucose curve ends up in the middle of these lines, or close to the one which makes assumptions that closest resemble your situation.
@@ -223,7 +216,7 @@ Usually your real glucose curve ends up in the middle of these lines, or close t
### Section G - additional graphs
* You can activate up to four additional graphs below the main graph.
-* To open settings for additional graphs click the triangle on the right side of the [main graph](Screenshots-section-f-main-graph) and scroll down.
+* To open settings for additional graphs click the triangle on the right side of the [main graph](#section-f---main-graph) and scroll down.
@@ -234,9 +227,9 @@ Usually your real glucose curve ends up in the middle of these lines, or close t
#### Insulin on board
* Shows the insulin you have on board (= active insulin in your body). It includes insulin from bolus and temporary basal (**but excludes basal rates set in your profile**).
-* If there were no [SMBs](Open-APS-features-super-micro-bolus-smb), no boluses and no TBR during DIA time this would be zero.
+* If there were no [SMBs](../Usage/Open-APS-features.md#super-micro-bolus-smb), no boluses and no TBR during DIA time this would be zero.
* IOB can be negative if you have no remaining bolus and zero/low temp for a longer time.
-* Decaying depends on your [DIA and insulin profile settings](Config-Builder-local-profile).
+* Decaying depends on your [DIA and insulin profile settings](../Configuration/Config-Builder.md#local-profile).
#### Carbs On Board
* Shows the carbs you have on board (= active, not yet decayed carbs in your body).
@@ -245,13 +238,13 @@ Usually your real glucose curve ends up in the middle of these lines, or close t
#### Deviations
* **GREY** bars show a deviation due to carbs.
-* **GREEN** bars show that BG is higher than the algorithm expected it to be. Green bars are used to increase resistance in [Autosens](Open-APS-features-autosens).
-* **RED** bars show that BG is lower than the algorithm expected. Red bars are used to increase sensitivity in [Autosens](Open-APS-features-autosens).
+* **GREEN** bars show that BG is higher than the algorithm expected it to be. Green bars are used to increase resistance in [Autosens](../Usage/Open-APS-features.md#autosens).
+* **RED** bars show that BG is lower than the algorithm expected. Red bars are used to increase sensitivity in [Autosens](../Usage/Open-APS-features.md#autosens).
* **YELLOW** bars show a deviation due to UAM.
* **BLACK** bars show small deviations not taken into account for sensitivity
#### Sensitivity
-* Shows the sensitivity that [Autosens](Open-APS-features-autosens) has detected.
+* Shows the sensitivity that [Autosens](../Usage/Open-APS-features.md#autosens) has detected.
* Sensitivity is a calculation of sensitivity to insulin as a result of exercise, hormones etc.
#### Activity
@@ -270,14 +263,14 @@ Usually your real glucose curve ends up in the middle of these lines, or close t
* If connection to pump is lost, the insulin button will not be visible.
-* Other Buttons have to be setup in [preferences]Preferences-buttons).
+* Other Buttons have to be setup in [preferences](../Configuration/Preferences.md#buttons).
#### Insulin
-* To give a certain amount of insulin without using [bolus calculator](Screenshots-bolus-wizard).
-* By checking the box you can automatically start your [eating soon temp target](Preferences-default-temp-targets).
+* To give a certain amount of insulin without using [bolus calculator](#bolus-wizard).
+* By checking the box you can automatically start your [eating soon temp target](../Configuration/Preferences.md#default-temp-targets).
* If you do not want to bolus through pump but record insulin amount (i.e. insulin given by syringe) check the corresponding box.
#### Carbs
@@ -285,29 +278,27 @@ Usually your real glucose curve ends up in the middle of these lines, or close t
* To record carbs without bolusing.
-* Certain [pre-set temporary targets](Preferences-default-temp-targets) can be set directly by checking the box.
+* Certain [pre-set temporary targets](../Configuration/Preferences.md#default-temp-targets) can be set directly by checking the box.
* Time offset: When will you / have you been eaten carbs (in minutes).
* Duration: To be used for ["extended carbs"](../Usage/Extended-Carbs.md)
* You can use the buttons to quickly increase carb amount.
-* Notes will be uploaded to Nightscout - depending on your settings for [NS client](Preferences-nsclient).
+* Notes will be uploaded to Nightscout - depending on your settings for [NS client](../Configuration/Preferences.md#nsclient).
#### Calculator
-* See Bolus Wizard [section below](Screenshots-bolus-wizard)
+* See Bolus Wizard [section below](#bolus-wizard)
#### Calibrations
* Sends a calibration to xDrip+ or opens Dexcom calibration dialogue.
-* Must be activated in [preferences](Preferences-buttons).
+* Must be activated in [preferences](../Configuration/Preferences.md#buttons).
#### CGM
* Opens xDrip+.
* Back button returns to AAPS.
-* Must be activated in [preferences](Preferences-buttons).
+* Must be activated in [preferences](../Configuration/Preferences.md#buttons).
#### Quick Wizard
* Easily enter amount of carbs and set calculation basics.
-* Details are setup in [preferences](Preferences-quick-wizard).
-
-(Screenshots-bolus-wizard)=
+* Details are setup in [preferences](../Configuration/Preferences.md#quick-wizard).
## Bolus Wizard
@@ -328,14 +319,14 @@ When you want to make a meal bolus this is where you will normally make it from.
### Section J
-* SUPER BOLUS is where the basal insulin for the next two hours is added to the immediate bolus and a zero TBR is issued for the following two hours to take back the extra insulin. The option only shows when "Enable [superbolus](Preferences-superbolus) in wizard" is set in the [preferences overview](Preferences-overview).
+* SUPER BOLUS is where the basal insulin for the next two hours is added to the immediate bolus and a zero TBR is issued for the following two hours to take back the extra insulin. The option only shows when "Enable [superbolus](../Configuration/Preferences.md#superbolus) in wizard" is set in the [preferences overview](../Configuration/Preferences.md#overview).
* The idea is to deliver the insulin sooner and hopefully reduce spikes.
* For details visit [diabetesnet.com](https://www.diabetesnet.com/diabetes-technology/blue-skying/super-bolus/).
### Section K
* Shows the calculated bolus.
* If the amount of insulin on board already exceeds the calculated bolus then it will just display the amount of carbs still required.
-* Notes will be uploaded to Nightscout - depending on your settings for [NS client](Preferences-nsclient).
+* Notes will be uploaded to Nightscout - depending on your settings for [NS client](../Configuration/Preferences.md#nsclient).
### Section L
* Details of wizard's bolus calculation.
@@ -355,7 +346,7 @@ When you want to make a meal bolus this is where you will normally make it from.
* If you see the warning above after using bolus wizard, AAPS has detected that the calculated COB value maybe wrong.
* So, if you want to bolus again after a previous meal with COB you should be aware of overdosing!
-* For details see the hints on [COB calculation page](COB-calculation-detection-of-wrong-cob-values).
+* For details see the hints on [COB calculation page](../Usage/COB-calculation.md#detection-of-wrong-cob-values).
(Screenshots-action-tab)=
## Action tab
@@ -363,10 +354,10 @@ When you want to make a meal bolus this is where you will normally make it from.
### Actions - section M
-* Button [profile switch](Profiles-profile-switch) as an alternative to pressing the [current profile](Screenshots-section-b-profile-target) on homescreen.
-* Button [temporary target](temptarget-temp-targets) as an alternative to pressing the [current target](Screenshots-section-b-profile-target) on homescreen.
+* Button [profile switch](../Usage/Profiles.md#profile-switch--profile-percentage) as an alternative to pressing the [current profile](#section-b---profile--target) on homescreen.
+* Button [temporary target](../Usage/temptarget.md) as an alternative to pressing the [current target](#section-b---profile--target) on homescreen.
* Button to start or cancel a temporary basal rate. Please note that the button changes from “TEMPBASAL” to “CANCEL x%” when a temporary basal rate is set.
-* Even though [extended boluses](Extended-Carbs-extended-bolus-and-why-they-wont-work-in-closed-loop-environment) do not really work in a closed loop environment some people were asking for an option to use extended bolus anyway.
+* Even though [extended boluses](../Usage/Extended-Carbs.md#extended-bolus-and-why-they-wont-work-in-closed-loop-environment) do not really work in a closed loop environment some people were asking for an option to use extended bolus anyway.
* This option is only available for Dana RS and Insight pumps.
* Closed loop will automatically be stopped and switched to open loop mode for the time running extended bolus.
@@ -383,20 +374,20 @@ When you want to make a meal bolus this is where you will normally make it from.
* cannula age
* pump battery age & level (percentage
-* Less information will be shown if [low resolution skin](Preferences-skin) is used.
+* Less information will be shown if [low resolution skin](../Configuration/Preferences.md#skin) is used.
(Screenshots-sensor-level-battery)=
#### Sensor level (battery)
* Needs xDrip+ nightly build Dec. 10, 2020 or newer.
* Works for CGM with additional transmitter such as MiaoMiao 2. (Technically sensor has to send cat level information to xDrip+.)
-* Thresholds can be set in [preferences](Preferences-status-lights).
+* Thresholds can be set in [preferences](../Configuration/Preferences.md#status-lights).
* If sensor level is the same as phone battery level you xDrip+ version is probably too old and needs an update.
### Careportal - section O
-* BG check, prime/fill, sensor insert and pump battery change are the base for the data displayed in [section N](Screenshots-careportal-section-n).
+* BG check, prime/fill, sensor insert and pump battery change are the base for the data displayed in [section N](#careportal---section-n).
* Prime/Fill allows you to record pump site and insulin cartridge change.
* Section O reflects the Nightscout careportal. So exercise, announcement and question are special forms of notes.
@@ -419,7 +410,7 @@ When you want to make a meal bolus this is where you will normally make it from.
-* This shows the activity profile of the insulin you have chosen in [config builder](Config-Builder-insulin).
+* This shows the activity profile of the insulin you have chosen in [config builder](../Configuration/Config-Builder.md#insulin).
* The PURPLE line shows how much insulin remains after it has been injected as it decays with time and the BLUE line shows how active it is.
* The important thing to note is that the decay has a long tail.
* If you have been used to manual pumping you have probably been used to assuming that insulin decays over about 3.5 hours.
@@ -435,7 +426,7 @@ And even more at: [Exponential Insulin Curves + Fiasp](https://seemycgm.com/2017
* Different information on pump status. Displayed information depends on your pump model.
-* See [pumps page](../Hardware/pumps.md) for details.
+* See [pumps page](../Getting-Started/CompatiblePumps.md) for details.
## Care Portal
@@ -444,7 +435,7 @@ Careportal replicated the functions you will find on your Nightscout screen unde
### Review carb calculation
-* If you have used the [Bolus Wizard](Screenshots-bolus-wizard) to calculate insulin dosage you can review this calculation later on ts tab.
+* If you have used the [Bolus Wizard](#bolus-wizard) to calculate insulin dosage you can review this calculation later on ts tab.
* Just press the green Calc link. (Depending on pump used insulin and carbs can also be shown in one single line in ts.)
(Screenshots-carb-correction)=
@@ -467,7 +458,7 @@ Treatment tab can be used to correct faulty carb entries (i.e. you over- or unde
## Loop, AMA / SMB
* These tabs show details about the algorithm's calculations and why AAPS acts the way it does.
* Calculations are each time the system gets a fresh reading from the CGM.
-* For more details see [APS section on config builder page](Config-Builder-aps).
+* For more details see [APS section on config builder page](../Configuration/Config-Builder.md#aps).
## Profile
@@ -480,19 +471,17 @@ Treatment tab can be used to correct faulty carb entries (i.e. you over- or unde
* Basal rate
* Target: Blood glucose level that you want AAPS to be aiming for
-* As of version 3.0 only [local profile](Config-Builder-local-profile) is possible. The local profile can be edited on your smartphone and synced to your Nightscout site.
-
(Screenshots-treatment)=
## Treatment
History of the following treatments:
-* Bolus & carbs -> option to [remove entries](Screenshots-carb-correction) to correct history
-* [Extended bolus](Extended-Carbs-extended-bolus-and-switch-to-open-loop-dana-and-insight-pump-only)
+* Bolus & carbs -> option to [remove entries](#carb-correction) to correct history
+* [Extended bolus](../Usage/Extended-Carbs.md#extended-bolus-and-switch-to-open-loop---dana-and-insight-pump-only)
* Temporary basal rate
* [Temporary target](../Usage/temptarget.md)
* [Profile switch](../Usage/Profiles.md)
-* [Careportal](CPbefore26-careportal-discontinued) - notes entered through action tab and notes in dialogues
+* Careportal - notes entered through action tab and notes in dialogues
## BG Source - xDrip+, BYODA...
@@ -504,5 +493,5 @@ History of the following treatments:
* Displays status of the connection with your Nightscout site.
-* Settings are made in [preferences](Preferences-nsclient). You can open the corresponding section by clicking the cog wheel on the top right side of the screen.
+* Settings are made in [preferences](../Configuration/Preferences.md#nsclient). You can open the corresponding section by clicking the cog wheel on the top right side of the screen.
* For troubleshooting see this [page](../Usage/Troubleshooting-NSClient.md).
diff --git a/docs/EN/Getting-Started/WikiUpdate.md b/docs/EN/Getting-Started/WikiUpdate.md
index a0aa3d8e88bc..6a9c31e5cc68 100644
--- a/docs/EN/Getting-Started/WikiUpdate.md
+++ b/docs/EN/Getting-Started/WikiUpdate.md
@@ -2,10 +2,10 @@
## February 2022
-- [BG quality warning sign](Screenshots-bg-warning-sign) @tanja
-- [Medtronic pump update](../Configuration/MedtronicPump.md) @dottedfingertips
+- [BG quality warning sign](../Getting-Started/Screenshots.md#bg-warning-sign) @tanja
+- [Medtronic pump update](../CompatiblePumps/MedtronicPump.md) @dottedfingertips
- [Necessary checks after update to AAPS 3.0](../Installing-AndroidAPS/update3_0.md) @tanja
-- [Omnipod Dash](../Configuration/OmnipodDASH.md) @Freloner @ robertrub @vanelsberg
+- [Omnipod Dash](../CompatiblePumps/OmnipodDASH.md) @Freloner @ robertrub @vanelsberg
- Update docs for AAPS 3.0 (partly) @xJoe
- [Wear OS for AAPS 3.0](../Configuration/Watchfaces.md) @peterleimbach
@@ -15,15 +15,15 @@
## December 2021
-- [Building the APK](../Installing-AndroidAPS/Building-APK.md) - update Android Studio Arctic Fox | 2020.3.1 @tanja
-- [Dana-i](../Configuration/DanaRS-Insulin-Pump.md) information added @MilosKozak
+- [Building the APK](../Installing-AndroidAPS/building-AAPS.md) - update Android Studio Arctic Fox | 2020.3.1 @tanja
+- [Dana-i](../CompatiblePumps/DanaRS-Insulin-Pump.md) information added @MilosKozak
## November 2021
-- Best practices for calibrating a [libre 2 sensor](Libre2-best-practices-for-calibrating-a-libre-2-sensor)
-- [ISF](FAQ-impact) reformulation of impact
+- Best practices for calibrating a [libre 2 sensor](../CompatibleCgms/Libre2.md#best-practices-for-calibrating-a-libre-2-sensor)
+- [ISF](../Getting-Started/FAQ.md) reformulation of impact
- Update [troubleshooting Android stduio](../Installing-AndroidAPS/troubleshooting_androidstudio.md)
-- Removed patched [Dexcom](../Hardware/DexcomG6.md) app as it is obsolete
+- Removed patched [Dexcom](../CompatibleCgms/DexcomG6.md) app as it is obsolete
## October 2021
@@ -31,7 +31,7 @@
## September 2021
-- Recommended computer specification to [build AAPS app](Building-APK-recommended-specification-of-computer-for-building-apk-file)
+- Recommended computer specification to [build AAPS app](../Installing-AndroidAPS/building-AAPS.md#computer-and-software-specifications-for-building-aaps)
## June 2021
@@ -39,8 +39,8 @@
## April 2021
-- List of [communication devices](module-additional-communication-device) for Omnipod and Medtronic pumps
-- AAPS predictions in [Nightscout](Nightscout-manual-nightscout-setup)
+- List of [communication devices](../Module/module.md#additional-communication-device) for Omnipod and Medtronic pumps
+- AAPS predictions in [Nightscout](../Installing-AndroidAPS/Nightscout.md#manual-nightscout-setup)
## March 2021
@@ -48,26 +48,26 @@
## February 2021
-- New navigation bar and [language switch](../changelanguage.md)
+- New navigation bar and [language switch](../ChangeLanguage/ChangeLanguage.md)
## January 2021
-- [Action tab](Screenshots-action-tab) - more details on page 'AAPS screens'
-- Dexcom G6 with [Build Your Own Dexcom App](DexcomG6-if-using-g6-with-build-your-own-dexcom-app)
-- Libre smart reader [battery level](Screenshots-sensor-level-battery)
-- [Objectives](Objectives-objective-3-prove-your-knowledge) - new questions
-- Other [new AAPS 2.8.0 functions](Releasenotes-version-2-8-0)
+- [Action tab](../Getting-Started/Screenshots.md#action-tab) - more details on page 'AAPS screens'
+- Dexcom G6 with [Build Your Own Dexcom App](../CompatibleCgms/DexcomG6.md#if-using-g6-with-build-your-own-dexcom-app)
+- Libre smart reader [battery level](../Getting-Started/Screenshots.md#sensor-level-battery)
+- [Objectives](../Usage/completing-the-objectives.md#objective-3-prove-your-knowledge) - new questions
+- Other [new AAPS 2.8.0 functions](../Installing-AndroidAPS/Releasenotes.md#version-280)
## December 2020
-- [Libre 2](../Hardware/Libre2.md) - patched app does not work with US sensors
-- [OpenAPS hard-coded limits](Open-APS-features-overview-of-hard-coded-limits)
+- [Libre 2](../CompatibleCgms/Libre2.md) - patched app does not work with US sensors
+- [OpenAPS hard-coded limits](../Usage/Open-APS-features.md#overview-of-hard-coded-limits)
- Sony Smartwatch 3 [Manual Installation of Google Play Service](../Usage/SonySW3.md)
## October 2020
-- Accu-Chek Combo - update [time adjustment daylight savings time](Timezone-traveling-time-adjustment-daylight-savings-time-dst)
-- Accu-Chek Insight - Option to [upload absolute values](Accu-Chek-Insight-Pump-settings-in-aaps)
+- Accu-Chek Combo - update [time adjustment daylight savings time](../Usage/Timezone-traveling.md#time-adjustment-daylight-savings-time-dst)
+- Accu-Chek Insight - Option to [upload absolute values](../CompatiblePumps/Accu-Chek-Insight-Pump.md#settings-in-aaps)
- Logs - more details about [folder location](../Usage/Accessing-logfiles.md)
- Omnipod Eros - status update
- [SMS commands - time sync](../Children/SMS-Commands.md)
@@ -79,95 +79,95 @@
## June 2020
-- [Libre 2](../Hardware/Libre2.md) - more details patched Libre Link app & use of bluetooth transmitters
+- [Libre 2](../CompatibleCgms/Libre2.md) - more details patched Libre Link app & use of bluetooth transmitters
- [Time zone travelling](../Usage/Timezone-traveling.md) with Libre 2
## May 2020
-- [Extended bolus only for Dana + Insight pumps](Extended-Carbs-extended-bolus-and-switch-to-open-loop-dana-and-insight-pump-only)
-- [Insight deactivate vibration](Accu-Chek-Insight-Pump-vibration) (firmware 3.x only)
-- [Minimal request rate](Preferences-minimal-request-change) to reduce number of notifications in open loop mode
-- [Patched Libre Link app](Libre2-step-1-build-your-own-patched-librelink-app) - check if correctly patched
-- [Prediction lines](Screenshots-prediction-lines) - more details
+- [Extended bolus only for Dana + Insight pumps](../Usage/Extended-Carbs.md#extended-bolus-and-switch-to-open-loop---dana-and-insight-pump-only)
+- [Insight deactivate vibration](../CompatiblePumps/Accu-Chek-Insight-Pump.md#vibration) (firmware 3.x only)
+- [Minimal request rate](../Configuration/Preferences.md#minimal-request-change-) to reduce number of notifications in open loop mode
+- [Patched Libre Link app](../CompatibleCgms/Libre2.md#5-use-the-patched-librelink-app-with-xdrip) - check if correctly patched
+- [Prediction lines](../Getting-Started/Screenshots.md#prediction-lines) - more details
## April 2020
-- [Backdate insulin](CPbefore26-carbs-bolus) (i.e. given by syringe)
-- [Android 6 support will be discontinued in next master version](../Module/module-phone)
+- Backdate insulin (i.e. given by syringe)
+- Android 6 support will be discontinued in next master version
## March 2020
-- [Build apk with Android Studio 3.6.1](../Installing-AndroidAPS/Building-APK.md)
-- [DanaRS with firmware v3](../Configuration/DanaRS-Insulin-Pump.md) **cannot currently be used with AAPS!**
-- [Extended bolus and switch to open loop](Extended-Carbs-extended-bolus-and-switch-to-open-loop-dana-and-insight-pump-only)
+- [Build apk with Android Studio 3.6.1](../Installing-AndroidAPS/building-AAPS.md)
+- [DanaRS with firmware v3](../CompatiblePumps/DanaRS-Insulin-Pump.md) **cannot currently be used with AAPS!**
+- [Extended bolus and switch to open loop](../Usage/Extended-Carbs.md#extended-bolus-and-switch-to-open-loop---dana-and-insight-pump-only)
- [Update apk with Android Studio 3.6.1](../Installing-AndroidAPS/Update-to-new-version.md)
## February 2020
-- [Automation caveats](Automation-good-practice-caveats)
-- [Autosens](Open-APS-features-autosens) - short explanation
+- Automation caveats
+- [Autosens](../Usage/Open-APS-features.md#autosens) - short explanation
- [Careportal alternatives](../Usage/CPbefore26.md)
-- [Extended bolus](Extended-Carbs-extended-bolus-and-switch-to-open-loop-dana-and-insight-pump-only) feature - closed loop will be disabled
-- New [Local Profile plugin](Config-Builder-local-profile)
-- [Sample Setup](../Getting-Started/Sample-Setup.md) - update Dexcom G6
-- [Version 2.6.0](Releasenotes-version-2-6-0) - major new features
+- [Extended bolus](../Usage/Extended-Carbs.md#extended-bolus-and-switch-to-open-loop---dana-and-insight-pump-only) feature - closed loop will be disabled
+- New [Local Profile plugin](../Configuration/Config-Builder.md#local-profile)
+- Sample Setup - update Dexcom G6
+- [Version 2.6.0](../Installing-AndroidAPS/Releasenotes.md#version-260) - major new features
- [Wear complications](../Configuration/Watchfaces.md)
## January 2020
-- [Manual carb correction](Screenshots-carb-correction) for faulty carb entries
-- [Image size](make-a-PR-image-size) when editing docs
+- [Manual carb correction](../Getting-Started/Screenshots.md#carb-correction) for faulty carb entries
+- [Image size](../make-a-PR.md) when editing docs
## December 2019
- [Android auto](../Usage/Android-auto.md) - setup with screenshots
-- [Accu-Chek Insight & Autotune](Accu-Chek-Insight-Pump-settings-in-aaps) - workaround for usage
-- [Glimp](Config-Builder-bg-source) - version 4.15.57 and newer supported
+- [Accu-Chek Insight & Autotune](../CompatiblePumps/Accu-Chek-Insight-Pump.md#settings-in-aaps) - workaround for usage
+- [Glimp](../Configuration/Config-Builder.md#bg-source) - version 4.15.57 and newer supported
- [Watchfaces](../Configuration/Watchfaces.md) - major update, way more details
-- [Watchface complications](Watchfaces-complications) - use your favorite watchface with AAPS data
+- [Watchface complications](../Configuration/Watchfaces.md#complications) - use your favorite watchface with AAPS data
## November 2019
-- [Automation - deactivate when disabling loop](Automation-important-note)
-- [Dexcom G6 replace transmitter update](xdrip-replace-transmitter)
-- [Extended bolus - why they do not work in a loop context](Extended-Carbs-extended-bolus-and-switch-to-open-loop-dana-and-insight-pump-only)
-- [FAQ - sports](FAQ-sports)
-- [Homescreen - lines on graph](Screenshots-section-f-main-graph)
-- [Insight - Disable absolute values in NS Client](Accu-Chek-Insight-Pump-settings-in-aaps)
-- [Medtronic pump - possible double entries](../Configuration/MedtronicPump.md)
-- [New Freestyle Libre 2 tutorial](../Hardware/Libre2.md)
+- [Automation - deactivate when disabling loop](../Usage/Automation.md)
+- [Dexcom G6 replace transmitter update](../CompatibleCgms/xDrip.md#replace-transmitter)
+- [Extended bolus - why they do not work in a loop context](../Usage/Extended-Carbs.md#extended-bolus-and-switch-to-open-loop---dana-and-insight-pump-only)
+- [FAQ - sports](../Getting-Started/FAQ.md#sports)
+- [Homescreen - lines on graph](../Getting-Started/Screenshots.md#section-f---main-graph)
+- [Insight - Disable absolute values in NS Client](../CompatiblePumps/Accu-Chek-Insight-Pump.md#settings-in-aaps)
+- [Medtronic pump - possible double entries](../CompatiblePumps/MedtronicPump.md)
+- [New Freestyle Libre 2 tutorial](../CompatibleCgms/Libre2.md)
- [Profile switch with percentage - example](../Usage/Profiles.md)
- [SMS commands update](../Children/SMS-Commands.md)
- [Troubleshooting Android Studio](../Installing-AndroidAPS/troubleshooting_androidstudio.md)
- [Troubleshooting - link collection](../Usage/troubleshooting.md)
- Update - quick walk-through for experienced users
-- Docs - update [edit](make-a-PR-code-syntax) and [translation](translations#translation-of-the-documentation).
+- Docs - update [edit](../make-a-PR.md#code-syntax) and [translation](../translations.md#translation-of-the-documentation).
## October 2019
-- [AAPS version 2.5](Releasenotes-version-2-5-0) updates (especially on [update page](Update-to-new-version.md))
-- [AccuChek Insight - log options](Accu-Chek-Insight-Pump-settings-in-aaps)
+- [AAPS version 2.5](../Installing-AndroidAPS/Releasenotes.md#version-250) updates (especially on [update page](../Installing-AndroidAPS/Update-to-new-version.md))
+- [AccuChek Insight - log options](../CompatiblePumps/Accu-Chek-Insight-Pump.md#settings-in-aaps)
- [COB calculation on separate page](../Usage/COB-calculation.md)
-- [COB - wrong COB value detection](COB-calculation-detection-of-wrong-cob-values)
-- [Dexcom G6 specific troubleshooting](DexcomG6-dexcom-g6-specific-troubleshooting)
-- [Objectives update version 2.5](../Usage/Objectives.md)
+- [COB - wrong COB value detection](../Usage/COB-calculation.md#detection-of-wrong-cob-values)
+- [Dexcom G6 specific troubleshooting](../CompatibleCgms/DexcomG6.md#dexcom-g6one-specific-troubleshooting)
+- [Objectives update version 2.5](../Usage/completing-the-objectives.md)
- [Preferences update](../Configuration/Preferences.md)
-- [SGLT-2 inhibitors - do not use when looping](module-no-use-of-sglt-2-inhibitors)
-- [SMS Commands Troubleshooting](SMS-Commands-troubleshooting)
-- [xDrip - update G6 transmitter replacement](xdrip-replace-transmitter)
+- [SGLT-2 inhibitors - do not use when looping](../Getting-Started/PreparingForAaps.md#no-sglt-2-inhibitors)
+- [SMS Commands Troubleshooting](../Children/SMS-Commands.md#troubleshooting)
+- [xDrip - update G6 transmitter replacement](../CompatibleCgms/xDrip.md#replace-transmitter)
## September 2019
- [Automate](../Usage/Automation.md)
-- [Bolus calculator](Screenshots-wrong-cob-detection) - slow carb absorption
-- [Nightscout security](Nightscout-security-considerations)
-- [Profile timeshift](Profiles-time-shift) (more details)
+- [Bolus calculator](../Getting-Started/Screenshots.md#wrong-cob-detection) - slow carb absorption
+- [Nightscout security](../Installing-AndroidAPS/Nightscout.md#security-considerations)
+- [Profile timeshift](../Usage/Profiles.md#time-shift-of-the-circadian-percentage-profile) (more details)
- [Remote monitoring](../Children/Children.md)
-- [What is a closed loop system?](../Getting-Started/ClosedLoop.md)
+- [What is a closed loop system?](../Getting-Started/Introduction.md#what-does-hybrid-closed-loop-mean)
## August 2019
- Dexcom G6 patched app region
-- [Dexcom G6 new transmitter](xdrip-connect-g6-transmitter-for-the-first-time) ("firefly" / 8G...)
-- [What do I need?](index-what-do-i-need) - new structure & additional information
+- [Dexcom G6 new transmitter](../CompatibleCgms/xDrip.md#connect-g6-transmitter-for-the-first-time) ("firefly" / 8G...)
+- What do I need? - new structure & additional information
- New structure
diff --git a/docs/EN/Hardware/Phoneconfig.md b/docs/EN/Hardware/Phoneconfig.md
deleted file mode 100644
index 30e7a736233b..000000000000
--- a/docs/EN/Hardware/Phoneconfig.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Phones
-
-- [List of tested phones](../Getting-Started/Phones.md)
-- [Jelly Pro Settings](../Usage/jelly.md)
-- [Huawei Settings](../Usage/huawei.md)
diff --git a/docs/EN/Hardware/pumps.md b/docs/EN/Hardware/pumps.md
deleted file mode 100644
index 6be3bea72766..000000000000
--- a/docs/EN/Hardware/pumps.md
+++ /dev/null
@@ -1,13 +0,0 @@
-# Pump Configuration
-
-* [Dana-R pump](../Configuration/DanaR-Insulin-Pump.md)
-* [Dana-RS pump](../Configuration/DanaRS-Insulin-Pump.md)
-* [Accu-Chek Combo pump](../Configuration/Accu-Chek-Combo-Pump.md)
-* [Accu-Chek Insight pump](../Configuration/Accu-Chek-Insight-Pump.md)
-* [Diaconn G8 insulin pump](../Configuration/DiaconnG8.md)
-* [Omnipod Eros](../Configuration/OmnipodEros.md)
-* [Omnipod DASH](../Configuration/OmnipodDASH.md)
-* [Medtrum Nano](../Configuration/MedtrumNano.md)
-* [Medtrum 300U](../Configuration/MedtrumNano.md)
-* [Medtronic pump](../Configuration/MedtronicPump.md)
-* [Future possible pump drivers](../Getting-Started/Future-possible-Pump-Drivers.md)
diff --git a/docs/EN/Installing-AndroidAPS/Releasenotes.md b/docs/EN/Installing-AndroidAPS/Releasenotes.md
index 3c67705b1398..e0744c559f76 100644
--- a/docs/EN/Installing-AndroidAPS/Releasenotes.md
+++ b/docs/EN/Installing-AndroidAPS/Releasenotes.md
@@ -7,7 +7,7 @@ You will receive the following information as soon as a new update is available:
-Then you have 60 days to update. If you do not update within these 60 days AAPS will fall back to LGS (low glucose suspend - see [glossary](../Getting-Started/Glossary.md)) as in [objective 6](../Usage/Objectives.html).
+Then you have 60 days to update. If you do not update within these 60 days AAPS will fall back to LGS (low glucose suspend - see [glossary](../Getting-Started/Glossary.md)) as in [objective 6](../Usage/completing-the-objectives.md).
If you do not update for another 30 days (90 days from new release date) AAPS will switch to Open Loop.
@@ -55,7 +55,7 @@ Release date: 23-10-2023
- NS 15 is required
- While using websockets in NS v3 plugin treatments entered through NS UI (plus button) and other applications using v1 API are not sent to AAPS. This will be fixed in future release of NS. Always use the same client (v1 or v3) in AAPS and AAPSClient until NS fully switch to v3 internaly. The same is valid for AAPS and AAPSClient itself.
-- Websockets in v3 plugin works similiar way to v1 plugin. Without websockets enabled AAPS schedules regularly downloads from NS which should lead to lower power consumption because NS is not permanently connected. On the oposite side it means delays in exchanging data. Please read [here](Important-comments-on-using-v3-versus-v1-API-for-Nightscout-with-AAPS) the important comments from the dev team before you use it!
+- Websockets in v3 plugin works similiar way to v1 plugin. Without websockets enabled AAPS schedules regularly downloads from NS which should lead to lower power consumption because NS is not permanently connected. On the oposite side it means delays in exchanging data. Please read [here](../Installing-AndroidAPS/Releasenotes.md#important-comments-on-using-v3-versus-v1-api-for-nightscout-with-aaps) the important comments from the dev team before you use it!
- If you are using xdrip as cgm source you must select it again after update due to internal changes
- Tidepool can be used as a replacement of NS to pass first objective
- If you send to xDrip+ you must configure xDrip synchronization plugin. In order to receive BGs from AAPS in xDrip, “xDrip+ Sync Follower” must be selected as source
@@ -175,11 +175,11 @@ Release date: 31-01-2022
- 100k lines changed, 105k new lines of code
-- [Omnipod DASH support](../Configuration/OmnipodDASH.md) @AdrianLxM @avereha @bartsopers @vanelsberg
+- [Omnipod DASH support](../CompatiblePumps/OmnipodDASH.md) @AdrianLxM @avereha @bartsopers @vanelsberg
-- [Dana-i support](../Configuration/DanaRS-Insulin-Pump.md) @MilosKozak
+- [Dana-i support](../CompatiblePumps/DanaRS-Insulin-Pump.md) @MilosKozak
-- [DiaconnG8 support](../Configuration/DiaconnG8.md)
+- [DiaconnG8 support](../CompatiblePumps/DiaconnG8.md)
- Glunovo support
@@ -200,9 +200,9 @@ Release date: 31-01-2022
- You can start activity temporary target during creation of profile switch @MilosKozak
-- NSProfile is gone, just local profile can be used. Local profile can be [synced to NS](update3_0-nightscout-profile-cannot-be-pushed). @MilosKozak.
+- NSProfile is gone, just local profile can be used. Local profile can be [synced to NS](../Installing-AndroidAPS/update3_0.md#nightscout-profile-cannot-be-pushed). @MilosKozak.
-- Forgotten [master password reset procedure](update3_0-reset-master-password) @MilosKozak
+- Forgotten [master password reset procedure](../Installing-AndroidAPS/update3_0.md#reset-master-password) @MilosKozak
- User actions tracing @Philoul
@@ -240,7 +240,7 @@ Release date: 31-01-2022
Release date: 23-01-2021
-- Please see also [important hints for version 2.8.1.1](Releasenotes-important-hints-2-8-1-1) below.
+- Please see also [important hints for version 2.8.1.1](#version-2811) below.
### Changes
@@ -285,24 +285,24 @@ Release date: 01-01-2021
### Important hints
- **Minimum Android version is 8.0 now.** For older Android versions you can still use 2.6.1.4 from old repo.
-- [Objectives have changed.](Objectives-objective-3-prove-your-knowledge) **Finish not completed objectives before update.**
-- Repository location still on . If you are not familiar with git the easiest way for update is remove directory with AAPS and do a [new clone](../Installing-AndroidAPS/Building-APK.md).
+- [Objectives have changed.](../Usage/completing-the-objectives.md#objective-3-prove-your-knowledge) **Finish not completed objectives before update.**
+- Repository location still on . If you are not familiar with git the easiest way for update is remove directory with AAPS and do a [new clone](../Installing-AndroidAPS/building-AAPS.md).
- Please use [Android Studio 4.1.1](https://developer.android.com/studio/) or newer to build the apk.
### Major new features
-- [Omnipod Eros support](../Configuration/OmnipodEros.md) @bartsopers @andyrozman @ktomy @samspycher @TeleRiddler @vanelsberg @eurenda and special thanks to @ps2 @itsmojo, everybody else involved in the Loop driver for Omnipod and @jlucasvt from GetRileyLink.org
-- [bolus advisor](Preferences-bolus-advisor) & [eating reminder](Screenshots-eating-reminder) @MilosKozak
-- [New watchface](Watchfaces-new-watchface-as-of-AAPS-2-8) @rICTx-T1D
+- [Omnipod Eros support](../CompatiblePumps/OmnipodEros.md) @bartsopers @andyrozman @ktomy @samspycher @TeleRiddler @vanelsberg @eurenda and special thanks to @ps2 @itsmojo, everybody else involved in the Loop driver for Omnipod and @jlucasvt from GetRileyLink.org
+- [bolus advisor](../Configuration/Preferences.md#quick-wizard) & [eating reminder](../Getting-Started/Screenshots.md#eating-reminder) @MilosKozak
+- [New watchface](../Configuration/Watchfaces.md#new-watchface-as-of-aaps-28) @rICTx-T1D
- Dana RS connection improvements @MilosKozak
- Removed "Unchanged CGM values" behavior in SMB for Dexcom native app
-- New [Low Ressolution Skin](Preferences-skin)
-- New ["Pregnant" patient type](Open-APS-features-overview-of-hard-coded-limits) @Brian Quinion
+- New [Low Ressolution Skin](../Configuration/Preferences.md#skin)
+- New ["Pregnant" patient type](../Usage/Open-APS-features.md#overview-of-hard-coded-limits) @Brian Quinion
- New NSClient tablet layout @MilosKozak
- NSClient transfer insulin, senstivity and display settings directly from main AAPS @MilosKozak
- [Preferences filter](../Configuration/Preferences.md) @Brian Quinion
- New pump icons @Rig22 @@teleriddler @osodebailar
-- New [insulin type Lyumjev](Config-Builder-lyumjev)
+- New [insulin type Lyumjev](../Configuration/Config-Builder.md#lyumjev)
- SetupWizard improvements @MilosKozak
- Security improvements @dlvoy
- Various improvements and fixes @AdrianLxM @Philoul @swissalpine @MilosKozak @Brian Quinion
@@ -314,34 +314,34 @@ Release date: 24-09-2020
**Make sure to check and adjust settings after updating to 2.7 as described** [here](../Installing-AndroidAPS/update2_7.md).
-You need at least start [objective 11 (in later versions objective 10!)](Objectives-objective-10-automation) in order to continue using [Automation feature](../Usage/Automation.md) (all previous objectives must be completed otherwise starting Objective 11 is not possible). If for example you did not finish the exam in [objective 3](Objectives-objective-3-prove-your-knowledge) yet, you will have to complete the exam before you can start [objective 11](Objectives-objective-10-automation). This will not effect other objectives you have already finished. You will keep all finished objectives!
+You need at least start [objective 11 (in later versions objective 10!)](../Usage/completing-the-objectives.md#objective-10-automation) in order to continue using [Automation feature](../Usage/Automation.md) (all previous objectives must be completed otherwise starting Objective 11 is not possible). If for example you did not finish the exam in [objective 3](../Usage/completing-the-objectives.md#objective-3-prove-your-knowledge) yet, you will have to complete the exam before you can start [objective 11](../Usage/completing-the-objectives.md#objective-11-enabling-additional-features-for-daytime-use-such-as-dynamic-senstivity-plugin-dynisf). This will not effect other objectives you have already finished. You will keep all finished objectives!
### Major new features
- internal use of dependency injection, updates libraries, code rewritten to kotlin @MilosKozak @AdrianLxM
- using modules for Dana pumps @MilosKozak
- [new layout, layout selection](../Getting-Started/Screenshots.md) @MilosKozak
-- new [status lights layout](Preferences-status-lights) @MilosKozak
-- [multiple graphs support](Screenshots-section-f-main-graph) @MilosKozak
+- new [status lights layout](../Configuration/Preferences.md#status-lights) @MilosKozak
+- [multiple graphs support](../Getting-Started/Screenshots.md#activate-optional-information) @MilosKozak
- [Profile helper](../Configuration/profilehelper.md) @MilosKozak
-- visualization of [dynamic target adjustment](Screenshots-visualization-of-dynamic-target-adjustment) @Tornado-Tim
+- visualization of [dynamic target adjustment](../Getting-Started/Screenshots.md#visualization-of-dynamic-target-adjustment) @Tornado-Tim
- new [preferences layout](../Configuration/Preferences.md) @MilosKozak
- SMB algorithm update @Tornado-Tim
-- [Low glucose suspend mode](Preferences-aps-mode) @Tornado-Tim
-- [carbs required notifications](Preferences-carb-required-notification) @twain47 @Tornado-Tim
+- [Low glucose suspend mode](../Configuration/Preferences.md#aps-mode) @Tornado-Tim
+- [carbs required notifications](../Configuration/Preferences.md#carb-required-notification) @twain47 @Tornado-Tim
- removed Careportal (moved to Actions) @MilosKozak
- [new encrypted backup format](../Usage/ExportImportSettings.md) @dlvoy
- [new SMS TOTP authentication](../Children/SMS-Commands.md) @dlvoy
-- [new SMS PUMP CONNECT, DISCONNECT](SMS-Commands-commands) commands @Lexsus
+- [new SMS PUMP CONNECT, DISCONNECT](../Children/SMS-Commands.md#commands) commands @Lexsus
- better support for tiny basals on Dana pumps @Mackwe
- small Insight fixes @TebbeUbben @MilosKozak
-- ["Default language" option](Preferences-general) @MilosKozak
+- ["Default language" option](../Configuration/Preferences.md#general) @MilosKozak
- vector icons @Philoul
-- [set neutral temps for MDT pump](MedtronicPump-configuration-of-the-pump) @Tornado-Tim
+- [set neutral temps for MDT pump](../CompatiblePumps/MedtronicPump.md#configuration-of-the-pump) @Tornado-Tim
- History browser improvements @MilosKozak
- removed OpenAPS MA algorithm @Tornado-Tim
- removed Oref0 sensitivity @Tornado-Tim
-- [Biometric or password protection](Preferences-protection) for settings, bolus @MilosKozak
+- [Biometric or password protection](../Configuration/Preferences.md#protection) for settings, bolus @MilosKozak
- [new automation trigger](../Usage/Automation.md) @PoweRGbg
- [Open Humans uploader](../Configuration/OpenHumans.md) @TebbeUbben @AdrianLxM
- New documentation @Achim
@@ -404,7 +404,7 @@ Please use [Android Studio 3.6.1](https://developer.android.com/studio/) or newe
- Fixed small UI bugs
- Fixed Insight crashes
- Fixed future carbs with Combo pump
-- Fixed [LocalProfile -> NS sync](Config-Builder-upload-local-profiles-to-nightscout)
+- Fixed LocalProfile -> NS sync
- Insight alerts improvements
- Improved detection of boluses from pump history
- Fixed NSClient connection settings (wifi, charging)
@@ -423,7 +423,7 @@ Please use [Android Studio 3.6.1](https://developer.android.com/studio/) or newe
- Careportal tab / menu removed - more details [here](../Usage/CPbefore26.md)
-- New [Local Profile plugin](Config-Builder-local-profile)
+- New Local Profile plugin
- Local profile can hold more than 1 profile
- Profiles can be cloned and edited
@@ -433,7 +433,7 @@ Please use [Android Studio 3.6.1](https://developer.android.com/studio/) or newe
- SimpleProfile is removed
-- [Extended bolus](Extended-Carbs-extended-bolus-and-switch-to-open-loop-dana-and-insight-pump-only) feature - closed loop will be disabled
+- [Extended bolus](../Usage/Extended-Carbs.md#extended-bolus-and-switch-to-open-loop---dana-and-insight-pump-only) feature - closed loop will be disabled
- MDT plugin: Fixed bug with duplicated entries
@@ -449,9 +449,9 @@ Please use [Android Studio 3.6.1](https://developer.android.com/studio/) or newe
- Fixed language support
-- Objectives: [Allow to go back](Objectives-go-back-in-objectives), Time fetching dialog
+- Objectives: [Allow to go back](../Usage/completing-the-objectives.md#go-back-in-objectives), Time fetching dialog
-- Automation: [allow sorting](Automation-sort-automation-rules)
+- Automation: [allow sorting](../Usage/Automation.md#the-order-of-the-automations-in-the-list-matters)
- Automation: fixed bug when automation was running with disabled loop
@@ -473,7 +473,7 @@ Please use [Android Studio 3.6.1](https://developer.android.com/studio/) or newe
Release date: 31-10-2019
-Please note the [important notes](Releasenotes-important-notes-2-5-0) and [limitations](Releasenotes-is-this-update-for-me-currently-is-not-supported) listed for [version 2.5.0](Releasenotes-version-2-5-0).
+Please note the [important notes](../Installing-AndroidAPS/Releasenotes.md#version-250) and [limitations](../Installing-AndroidAPS/Releasenotes.md#is-this-update-for-me-currently-is-not-supported) listed for [version 2.5.0](../Installing-AndroidAPS/Releasenotes.md#version-250).
\* Fixed a bug in the network state receiver that lead to crashes with many (not critical but would waste a lot of energy re-calculating things).
\* New versioning that will allow to do minor updates without triggering the update-notification.
@@ -486,8 +486,8 @@ Release date: 26-10-2019
### Important notes
-- Please use [Android Studio Version 3.5.1](https://developer.android.com/studio/) or newer to [build the apk](../Installing-AndroidAPS/Building-APK.md) or [update](../Installing-AndroidAPS/Update-to-new-version.html).
-- If you are using xDrip [identify receiver](xdrip-identify-receiver) must be set.
+- Please use [Android Studio Version 3.5.1](https://developer.android.com/studio/) or newer to [build the apk](../Installing-AndroidAPS/building-AAPS.md) or [update](../Installing-AndroidAPS/Update-to-new-version.md).
+- If you are using xDrip [identify receiver](../CompatibleCgms/xDrip.md#identify-receiver) must be set.
- If you are using Dexcom G6 with the patched Dexcom app you will need the version from the [2.4 folder](https://github.com/dexcomapp/dexcomapp/tree/master/2.4).
- Glimp is supported from version 4.15.57 and newer.
@@ -503,15 +503,15 @@ Release date: 26-10-2019
- Internal change of targetSDK to 28 (Android 9), jetpack support
- RxJava2, Okhttp3, Retrofit support
-- Old [Medtronic pumps](../Configuration/MedtronicPump.md) support (RileyLink need)
+- Old [Medtronic pumps](../CompatiblePumps/MedtronicPump.md) support (RileyLink need)
- New [Automation plugin](../Usage/Automation.md)
-- Allow to [bolus only part](Preferences-advanced-settings-overview) from bolus wizard calculation
+- Allow to [bolus only part](../Configuration/Preferences.md#advanced-settings-overview) from bolus wizard calculation
- Rendering insulin activity
- Adjusting IOB predictions by autosens result
- New support for patched Dexcom apks ([2.4 folder](https://github.com/dexcomapp/dexcomapp/tree/master/2.4))
- Signature verifier
- Allow to bypass objectives for OpenAPS users
-- New [objectives](../Usage/Objectives.md) - exam, application handling
+- New [objectives](../Usage/completing-the-objectives.md) - exam, application handling
(If you started at least objective "Starting on an open loop" in previous versions exam is optional.)
- Fixed bug in Dana\* drivers where false time difference was reported
- Fixed bug in [SMS communicator](../Children/SMS-Commands.md)
@@ -549,7 +549,7 @@ Release date: 29-03-2019
### Major new features
-- [DST fix](Timezone-traveling-time-adjustment-daylight-savings-time-dst)
+- [DST fix](../Usage/Timezone-traveling.md#time-adjustment-daylight-savings-time-dst)
- Wear Update
- [SMS plugin](../Children/SMS-Commands.md) update
- Go back in objectives.
@@ -561,7 +561,7 @@ Release date: 03-03-2019
### Major new features
-- [Accu-Chek Insight](../Configuration/Accu-Chek-Insight-Pump.md) support (by Tebbe Ubben and JamOrHam)
+- [Accu-Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md) support (by Tebbe Ubben and JamOrHam)
- Status lights on main screen (Nico Schmitz)
- Daylight saving time helper (Roumen Georgiev)
- Fix processing profile names comming from NS (Johannes Mockenhaupt)
@@ -581,7 +581,7 @@ Release date: 03-11-2018
### Major new features
- oref1/SMB support ([oref1 documentation](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html)) Be sure to read the documentation to know what to expect of SMB, how it will behave, what it can achieve and how to use it so it can operate smoothly.
-- [\_Accu-Chek Combo](../Configuration/Accu-Chek-Combo-Pump.md) pump support
+- [\_Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump.md) pump support
- Setup wizard: guides you through the process of setting up AAPS
(Releasenotes-settings-to-adjust-when-switching-from-ama-to-smb)=
@@ -605,7 +605,7 @@ Release date: 03-11-2018
- Top ribbon gives access to suspend/disable loop, view/adjust profile and to start/stop temporary targets (TTs). TTs use defaults set in preferences. The new Hypo TT option is a high temp TT to prevent the loop from too aggressively overcorrection rescue carbs.
- Treatment buttons: old treatment button still available, but hidden by default. Visibility of buttons can now be configured. New insulin button, new carbs button (including [eCarbs/extended carbs](../Usage/Extended-Carbs.md))
-- [Colored prediction lines](../Getting-Started/Screenshots-prediction-lines)
+- [Colored prediction lines](../Getting-Started/Screenshots.md#prediction-lines)
- Option to show a notes field in insulin/carbs/calculator/prime+fill dialogs, which are uploaded to NS
- Updated prime/fill dialog allows priming and creating careportal entries for site change and cartridge change
diff --git a/docs/EN/Installing-AndroidAPS/Update-to-new-version.md b/docs/EN/Installing-AndroidAPS/Update-to-new-version.md
index bbf3370e235a..6e0d75ab09ba 100644
--- a/docs/EN/Installing-AndroidAPS/Update-to-new-version.md
+++ b/docs/EN/Installing-AndroidAPS/Update-to-new-version.md
@@ -13,18 +13,18 @@
## Overview for updating to a new version of AAPS
-1. [Export your settings](../Usage/ExportImportSettings-export-settings) from the existing **AAPS** version on your phone.
+1. [Export your settings](../Usage/ExportImportSettings.md) from the existing **AAPS** version on your phone.
You might not need it, but better be safe than sorry.
-2. [Update local copy](Update-to-new-version-update-your-local-copy) of the AAPS sourcecode (Git->Fetch and Git -> Pull)
-3. [Build signed APK](Update-to-new-version-build-the-signed-apk)
-4. [Transfer the built apk](Building-APK-transfer-apk-to-smartphone) to your phone and install it
-5. [Check the version](Update-to-new-version-check-aaps-version-on-phone) in AAPS
-6. Depending on your [BG source](../Configuration/BG-Source.md) make sure to [identify receiver](xdrip-identify-receiver) in xDrip or use the ['Build your own Dexcom App'](DexcomG6-if-using-g6-with-build-your-own-dexcom-app).
+2. [Update local copy](#2-update-your-local-copy) of the AAPS sourcecode (Git->Fetch and Git -> Pull)
+3. [Build signed APK](#3-build-the-signed-apk)
+4. [Transfer the built apk](#4-transfer-the-apk) to your phone and install it
+5. [Check the version](#6-check-aaps-version-on-phone) in AAPS
+6. Depending on your [BG source](../Getting-Started/CompatiblesCgms.md) make sure to [identify receiver](../CompatibleCgms/xDrip.md#identify-receiver) in xDrip or use the ['Build your own Dexcom App'](../CompatibleCgms/DexcomG6.md#if-using-g6-with-build-your-own-dexcom-app).
-In case you experience problems, see separate page for [troubleshooting Android Studio](../Installing-AndroidAPS/troubleshooting_androidstudio).
+In case you experience problems, see separate page for [troubleshooting Android Studio](../Installing-AndroidAPS/troubleshooting_androidstudio.md).
## 1. Export your settings
-See the [Export & import settings](ExportImportSettings-export-settings) page if you don't remember how to do this.
+See the [Export & import settings](../Usage/ExportImportSettings.md) page if you don't remember how to do this.
(Update-to-new-version-update-your-local-copy)=
## 2. Update your local copy
@@ -66,12 +66,12 @@ Note: The files that were updated may vary! This is not an indication
(Update-to-new-version-build-the-signed-apk)=
## 3. Build the Signed APK
-Your sourcecode is now the current released version. It's time to build the signed apk from it as described in the [build signed apk section](Building-APK-generate-signed-apk).
+Your sourcecode is now the current released version. It's time to build the signed apk from it as described in the [build signed apk section](../Installing-AndroidAPS/building-AAPS.md#build-the-aaps-signed-apk).
## 4. Transfer the apk
You need to transfer the apk to your phone so you can install it.
-See the instructions for [Transfer APK to smartphone](Building-APK-transfer-apk-to-smartphone)
+See the instructions for [Transfer APK to smartphone](../Installing-AndroidAPS/Transferring-and-installing-AAPS.md)
## 5. Install apk
@@ -92,6 +92,6 @@ If anything goes wrong, don't panic.
Take a breath!
-Then see the separate page [troubleshooting Android Studio](../Installing-AndroidAPS/troubleshooting_androidstudio) if your problem is already documented!
+Then see the separate page [troubleshooting Android Studio](../Installing-AndroidAPS/troubleshooting_androidstudio.md) if your problem is already documented!
If you need further help, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw).
diff --git a/docs/EN/Installing-AndroidAPS/setup-wizard.md b/docs/EN/Installing-AndroidAPS/setup-wizard.md
index 41ee9e7a25dd..1cb3696f4fd7 100644
--- a/docs/EN/Installing-AndroidAPS/setup-wizard.md
+++ b/docs/EN/Installing-AndroidAPS/setup-wizard.md
@@ -310,7 +310,7 @@ Press "NEXT" to go to the next screen:
### Blood sugar source
-Select the BG source you are using. Please read the documentation for your [BG source](../Configuration/BG-Source.md).
+Select the BG source you are using. Please read the documentation for your [BG source](../Getting-Started/CompatiblesCgms.md).
As there are several options available, we don't explain the configuration for all of them here. We are using Dexcom G6 with the BYODA app in our example here:
@@ -450,7 +450,7 @@ If your have already setup your profile in the steps before and you know how to
Otherwise, leave the Setup Wizard, using the arrow in the top left corner and let **AAPS** first show you some blood glucose values. You can come back anytime or use one of the direct configuration options (not using the Wizard).
-Please read the documentation for your [insulin pump](../Getting-Started/Pump-Choices.md).
+Please read the documentation for your [insulin pump](../Getting-Started/CompatiblePumps.md).
Press "NEXT" to go to the next screen.
diff --git a/docs/EN/Installing-AndroidAPS/update2_7.md b/docs/EN/Installing-AndroidAPS/update2_7.md
index 8fef025b0917..29dcd03c630b 100644
--- a/docs/EN/Installing-AndroidAPS/update2_7.md
+++ b/docs/EN/Installing-AndroidAPS/update2_7.md
@@ -2,13 +2,13 @@
- The program code was changed significantly when switching to AAPS 2.7.
- Therefore it is important that you make some changes or check settings after the update.
-- Please see [release notes](Releasenotes-version-2-7-0) for details on new and extended features.
+- Please see [release notes](../Installing-AndroidAPS/Releasenotes.md#version-270) for details on new and extended features.
## Check BG source
- Check if BG source is correct after update.
-- Especially when using [xDrip+](../Configuration/xdrip.md) it might happen, that BG source is changed to Dexcom app (patched).
-- Open [Config builder](Config-Builder-bg-source) (hamburger menu on top left side of home screen)
+- Especially when using [xDrip+](../CompatibleCgms/xDrip.md) it might happen, that BG source is changed to Dexcom app (patched).
+- Open [Config builder](../Configuration/Config-Builder.md#bg-source) (hamburger menu on top left side of home screen)
- Scroll down to "BG source".
- Select correct BG source if changes are necessary.
@@ -17,8 +17,8 @@
## Finish exam
- AAPS 2.7 contains new objective 11 (in later versions renumbered to objective 10!) for [automation](../Usage/Automation.md).
-- You have to finish exam ([objective 3 and 4](Objectives-objective-3-prove-your-knowledge)) in order to complete [objective 11](Objectives-objective-10-automation).
-- If for example you did not finish the exam in [objective 3](../Usage/Objectives-objective-3-prove-your-knowledge) yet, you will have to complete the exam before you can start [objective 11](Objectives-objective-10-automation).
+- You have to finish exam ([objective 3 and 4](../Usage/completing-the-objectives.md#objective-3-prove-your-knowledge)) in order to complete [objective 11](../Usage/completing-the-objectives.md#objective-11-enabling-additional-features-for-daytime-use-such-as-dynamic-senstivity-plugin-dynisf).
+- If for example you did not finish the exam in [objective 3](../Usage/completing-the-objectives.md#objective-3-prove-your-knowledge) yet, you will have to complete the exam before you can start [objective 11](../Usage/completing-the-objectives.md#objective-11-enabling-additional-features-for-daytime-use-such-as-dynamic-senstivity-plugin-dynisf).
- This will not effect other objectives you have already finished. You will keep all finished objectives!
## Set master password
@@ -39,7 +39,7 @@
- Make sure to store your exported settings not only on your phone but also in at least one safe place (your pc, cloud storage...).
- If you build AAPS 2.7 apk with the same keystore than in previous versions you can install new version without deleting the previous version.
- All settings as well as finished objectives will remain as they were in the previous version.
-- In case you have lost your keystore build version 2.7 with new keystore and import settings from previous version as described in the [troubleshooting section](troubleshooting_androidstudio-lost-keystore).
+- In case you have lost your keystore build version 2.7 with new keystore and import settings from previous version as described in the [troubleshooting section](../Installing-AndroidAPS/troubleshooting_androidstudio.md#lost-keystore).
## Autosens (Hint - no action necessary)
@@ -49,12 +49,12 @@
## Set Pump Password for Dana RS (if using Dana RS)
-- Pump password for [Dana RS](../Configuration/DanaRS-Insulin-Pump.md) was not checked in previous versions.
+- Pump password for [Dana RS](../CompatiblePumps/DanaRS-Insulin-Pump.md) was not checked in previous versions.
- Open Preferences (three-dot-menu on top right of screen)
- Scroll down and click triangle next to "Dana RS".
- Click "Pump password (v1 only)"
-- Enter pump password ([Default password](DanaRS-Insulin-Pump-default-password) is different depending on firmware version) and click OK.
+- Enter pump password ([Default password](../CompatiblePumps/DanaRS-Insulin-Pump.md#default-password) is different depending on firmware version) and click OK.
-To change password on Dana RS follow instructions on [DanaRS page](DanaRS-Insulin-Pump-change-password-on-pump).
+To change password on Dana RS follow instructions on [DanaRS page](../CompatiblePumps/DanaRS-Insulin-Pump.md#change-password-on-pump).
diff --git a/docs/EN/Module/module.md b/docs/EN/Module/module.md
index 5d6616cf1055..e38a32e60277 100644
--- a/docs/EN/Module/module.md
+++ b/docs/EN/Module/module.md
@@ -50,23 +50,23 @@ Any problems with the spreadsheet please send an email to [hardware@androidaps.o
AAPS **currently** works with
-- [Accu-Chek Combo](../Configuration/Accu-Chek-Combo-Pump.md) (Old driver that uses the additional Ruffy app)
-- [Accu-Chek Combo](../Configuration/Accu-Chek-Combo-Pump-v2.md) (New driver, available starting with AndroidAPS v.3.2)
-- [Accu-Chek Insight](../Configuration/Accu-Chek-Insight-Pump.md)
-- [DanaR](../Configuration/DanaR-Insulin-Pump.md)
-- [DanaRS](../Configuration/DanaRS-Insulin-Pump.md)
-- [Dana-i](../Configuration/DanaRS-Insulin-Pump.md)
-- [Diaconn G8 ](../Configuration/DiaconnG8.md)
-- [EOPatch2](../Configuration/EOPatch2.md)
-- [Omnipod Eros](../Configuration/OmnipodEros.md) ([additional communication device](module-additional-communication-device) needed)
-- [Omnipod DASH](../Configuration/OmnipodDASH.md)
-- [Medtrum Nano](../Configuration/MedtrumNano.md)
-- [Medtrum 300U](../Configuration/MedtrumNano.md)
-- Certain older [Medtronic](../Configuration/MedtronicPump.md) ([additional communication device](module-additional-communication-device) needed)
+- [Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump.md) (Old driver that uses the additional Ruffy app)
+- [Accu-Chek Combo](../CompatiblePumps/Accu-Chek-Combo-Pump-v2.md) (New driver, available starting with AndroidAPS v.3.2)
+- [Accu-Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md)
+- [DanaR](../CompatiblePumps/DanaR-Insulin-Pump.md)
+- [DanaRS](../CompatiblePumps/DanaRS-Insulin-Pump.md)
+- [Dana-i](../CompatiblePumps/DanaRS-Insulin-Pump.md)
+- [Diaconn G8 ](../CompatiblePumps/DiaconnG8.md)
+- [EOPatch2](../CompatiblePumps/EOPatch2.md)
+- [Omnipod Eros](../CompatiblePumps/OmnipodEros.md) ([additional communication device](#additional-communication-device) needed)
+- [Omnipod DASH](../CompatiblePumps/OmnipodDASH.md)
+- [Medtrum Nano](../CompatiblePumps/MedtrumNano.md)
+- [Medtrum 300U](../CompatiblePumps/MedtrumNano.md)
+- Certain older [Medtronic](../CompatiblePumps/MedtronicPump.md) ([additional communication device](#additional-communication-device) needed)
If no additional communication device is mentioned the communication betweeen insulin pump and AAPS is based on the integrated bluetooth stack of Android without the need of an additional communication device to translate the communnication protocol.
-**Other pumps** that may have the potential to work with AAPS are listed on the [Future (possible) Pumps](../Getting-Started/Future-possible-Pump-Drivers.md) page.
+**Other pumps** that may have the potential to work with AAPS are listed on the [Future (possible) Pumps](../CompatiblePumps/Future-possible-Pump-Drivers.md) page.
(module-additional-communication-device)=
#### Additional communication device
@@ -94,18 +94,17 @@ The advantages of the DanaR/RS and Dana-i vs. the Combo as the pump of choice ho
### BG Source
-This is just a short overview of all compatible CGMs/FGM with AAPS. For further details, look [here](../Configuration/BG-Source.md). Just a short hint: if you can display your glucose data in xDrip+ app or Nightscout website, you can choose xDrip+ (or Nightscout with web connection) as BG source in AAPS.
+This is just a short overview of all compatible CGMs/FGM with AAPS. For further details, look [here](../Getting-Started/CompatiblesCgms.md). Just a short hint: if you can display your glucose data in xDrip+ app or Nightscout website, you can choose xDrip+ (or Nightscout with web connection) as BG source in AAPS.
-- [Dexcom G7](../Hardware/DexcomG7.md): Works with xDrip+ or patched app
-- [Dexcom G6](../Hardware/DexcomG6.md): BOYDA is recommended as of version 3.0 (see [release notes](Releasenotes-important-hints-3-0-0) for details). xDrip+ must be at least version 2022.01.14 or newer
-- [Dexcom G5](../Hardware/DexcomG5.md): It works with xDrip+ app or patched Dexcom app
-- [Dexcom G4](../Hardware/DexcomG4.md): These sensors are quite old, but you can find instructions on how to use them with xDrip+ app
-- [Libre 3](../Hardware/Libre3.md): It works with xDrip+ (no transmitter needed)
-- [Libre 2](../Hardware/Libre2.md): It works with xDrip+ (no transmitter needed)
-- [Libre 1](../Hardware/Libre1.md): You need a transmitter like Bluecon or MiaoMiao for it (build or buy) and xDrip+ app
-- [Eversense](../Hardware/Eversense.md): It works so far only in combination with ESEL app and a patched Eversense-App (works not with Dana RS and LineageOS, but DanaRS and Android or Combo and Lineage OS work fine)
-- [Enlite (MM640G/MM630G)](../Hardware/MM640g.md): quite complicated with a lot of extra stuff
-- [PocTech](../Hardware/PocTech.md)
+- [Dexcom G7](../CompatibleCgms/DexcomG7.md): Works with xDrip+ or patched app
+- [Dexcom G6](../CompatibleCgms/DexcomG6.md): BOYDA is recommended as of version 3.0 (see [release notes](../Installing-AndroidAPS/Releasenotes.md#version-300) for details). xDrip+ must be at least version 2022.01.14 or newer
+- [Dexcom G5](../CompatibleCgms/DexcomG5.md): It works with xDrip+ app or patched Dexcom app
+- [Libre 3](../CompatibleCgms/Libre3.md): It works with xDrip+ (no transmitter needed)
+- [Libre 2](../CompatibleCgms/Libre2.md): It works with xDrip+ (no transmitter needed)
+- [Libre 1](../CompatibleCgms/Libre1.md): You need a transmitter like Bluecon or MiaoMiao for it (build or buy) and xDrip+ app
+- [Eversense](../CompatibleCgms/Eversense.md): It works so far only in combination with ESEL app and a patched Eversense-App (works not with Dana RS and LineageOS, but DanaRS and Android or Combo and Lineage OS work fine)
+- [Enlite (MM640G/MM630G)](../CompatibleCgms/MM640g.md): quite complicated with a lot of extra stuff
+- [PocTech](../CompatibleCgms/PocTech.md)
### Nightscout
@@ -117,7 +116,7 @@ Additional information on how to configure Nightscout for use with AAPS can be f
### AAPS-.apk file
-The basic component of the system. Before installing the app, you have to build the apk-file (which is the filename extension for an Android App) first. Instructions are [here](../Installing-AndroidAPS/Building-APK.md).
+The basic component of the system. Before installing the app, you have to build the apk-file (which is the filename extension for an Android App) first. Instructions are [here](../Installing-AndroidAPS/building-AAPS.md).
## Optional Modules
@@ -133,7 +132,7 @@ Any problems with the spreadsheet please send an email to [hardware@androidaps.o
### xDrip+
-Even if you don't need to have the xDrip+ App as BG Source, you can still use it for i.e. alarms or a good blood glucose display. You can have as many as alarms as you want, specify the time when the alarm should be active, if it can override silent mode, etc. Some xDrip+ information can be found [here](../Configuration/xdrip.md). Please be aware that the documentations to this app are not always up to date as its progress is quite fast.
+Even if you don't need to have the xDrip+ App as BG Source, you can still use it for i.e. alarms or a good blood glucose display. You can have as many as alarms as you want, specify the time when the alarm should be active, if it can override silent mode, etc. Some xDrip+ information can be found [here](../CompatibleCgms/xDrip.md). Please be aware that the documentations to this app are not always up to date as its progress is quite fast.
## What to do while waiting for modules
@@ -142,4 +141,4 @@ It sometimes takes a while to get all modules for closing the loop. But no worri
You can keep on reading through the docs here, get in touch with other loopers online or offline, [read](../Where-To-Go-For-Help/Background-reading.md) documentations or what other loopers write (even if you have to be careful, not everything is correct or good for you to reproduce).
**Done?**
-If you have your AAPS components all together (congrats!) or at least enough to start in open loop mode, you should first read through the [Objective description](../Usage/Objectives.md) before each new Objective and setup up your [hardware](index-component-setup).
+If you have your AAPS components all together (congrats!) or at least enough to start in open loop mode, you should first read through the [Objective description](../Usage/completing-the-objectives.md) before each new Objective and setup up your [hardware](index-component-setup).
diff --git a/docs/EN/Resources/clinician-guide-to-AndroidAPS.md b/docs/EN/Resources/clinician-guide-to-AndroidAPS.md
index b598e306af4a..1a5d2d11b8f4 100644
--- a/docs/EN/Resources/clinician-guide-to-AndroidAPS.md
+++ b/docs/EN/Resources/clinician-guide-to-AndroidAPS.md
@@ -7,9 +7,9 @@ This guide has some high-level information about DIY closed looping and specific
## The steps for building a DIY Closed Loop:
To start using AAPS, the following steps should be taken:
-* Find a [compatible pump](../Hardware/pumps.md), a [compatible Android device](https://docs.google.com/spreadsheets/d/1gZAsN6f0gv6tkgy9EBsYl0BQNhna0RDqA9QGycAqCQc/edit?usp=sharing), and a [compatible CGM source](../Configuration/BG-Source.md).
-* [Download the AAPS source code and build the software](../Installing-AndroidAPS/Building-APK.md).
-* [Configure the software to talk to their diabetes devices and specify settings and safety preferences](index-configuration).
+* Find a [compatible pump](../Getting-Started/CompatiblePumps.md), a [compatible Android device](https://docs.google.com/spreadsheets/d/1gZAsN6f0gv6tkgy9EBsYl0BQNhna0RDqA9QGycAqCQc/edit?usp=sharing), and a [compatible CGM source](../Getting-Started/CompatiblesCgms.md).
+* [Download the AAPS source code and build the software](../Installing-AndroidAPS/building-AAPS.md).
+* [Configure the software to talk to their diabetes devices and specify settings and safety preferences](../Installing-AndroidAPS/setup-wizard.md).
## How A DIY Closed Loop Works
@@ -41,7 +41,7 @@ AAPS is designed to transparently track all input data it gathers, the resulting
## Examples of AAPS algorithm decision making:
-AAPS uses the same core algorithm and feature set as OpenAPS. The algorithm makes multiple predictions (based on settings, and the situation) representing different scenarios of what might happen in the future. In Nightscout, these are displayed as “purple lines”. AAPS uses different colors to separate these [prediction lines](Releasenotes-overview-tab). In the logs, it will describe which of these predictions and which time frame is driving the necessary actions.
+AAPS uses the same core algorithm and feature set as OpenAPS. The algorithm makes multiple predictions (based on settings, and the situation) representing different scenarios of what might happen in the future. In Nightscout, these are displayed as “purple lines”. AAPS uses different colors to separate these [prediction lines](../Getting-Started/Screenshots.md#prediction-lines). In the logs, it will describe which of these predictions and which time frame is driving the necessary actions.
### Here are examples of the purple prediction lines, and how they might differ:
@@ -96,7 +96,7 @@ Much of the information about OpenAPS can be easily adapted to AAPS, with the ma
This is meant to be a high-level overview of how AAPS works. For more details, ask your patient, reach out to the community, or read the full AAPS documentation available online.
Additional recommended reading:
-* The [full AAPS documentation](../index)
+* The [full AAPS documentation](../index.md)
* The [OpenAPS Reference Design](https://OpenAPS.org/reference-design/), which explains how OpenAPS is designed for safety: https://openaps.org/reference-design/
* The [full OpenAPS documentation](https://openaps.readthedocs.io/en/latest/index.html)
* More [details on OpenAPS calculations](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/Understand-determine-basal.html#understanding-the-determine-basal-logic)
diff --git a/docs/EN/Sandbox/sandbox1.md b/docs/EN/Sandbox/sandbox1.md
index 0d762bbf1e63..3a127db063c3 100644
--- a/docs/EN/Sandbox/sandbox1.md
+++ b/docs/EN/Sandbox/sandbox1.md
@@ -22,13 +22,13 @@ This is an internal sandbox file for the documentation team to test
1. CROWDIN translation and
2. Read The Docs deployment.
-You can dirctly jump from here to the second label in this file - ["Jump"](sandbox1-this-is-another-test).
+You can dirctly jump from here to the second label in this file - ["Jump"](#this-is-another-test).
-And you can jump to the first label too - ["Jump"](sandbox1-this-is-a-test).
+And you can jump to the first label too - ["Jump"](#this-is-a-test).
Here you can jump to the second sandbox file - ["Jump"](./MoveTest/sandbox2.md).
-You can dirctly jump from here to the first label in the sandbox2.md file - ["Jump"](sandbox2-this-is-a-test).
+You can dirctly jump from here to the first label in the sandbox2.md file - ["Jump"](./MoveTest/sandbox2.md#this-is-a-test).
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
@@ -53,10 +53,9 @@ Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod
testing abbr : ISF, IOB
Links with anchor :
-- [how long will it take?](../preparing.md#how-long-will-it-take-to-set-everything-up)
+- [how long will it take?](../Getting-Started/PreparingForAaps.md#how-long-will-it-take-to-set-everything-up)
- [NSClient settings in Preferences](../Configuration/Preferences.md#nsclient).
- [prediction lines in AAPS OVERVIEW](../Getting-Started/Screenshots.md#prediction-lines) to header level 4
-- [prediction lines in AAPS OVERVIEW](../Getting-Started/Screenshots.md#screenshots-prediction-lines) to named anchor
- [Screenshots](../Getting-Started/Screenshots.md)
- [Screenshot main graph](../Getting-Started/Screenshots.md#section-f---main-graph) to header level 3
- [OpenAPS-features](../Usage/Open-APS-features.md#max-uh-a-temp-basal-can-be-set-to-openaps-max-basal)
diff --git a/docs/EN/Usage/completing-the-objectives.md b/docs/EN/Usage/completing-the-objectives.md
index b5f4346bd537..91bbf64de03e 100644
--- a/docs/EN/Usage/completing-the-objectives.md
+++ b/docs/EN/Usage/completing-the-objectives.md
@@ -19,9 +19,9 @@ The **settings** file will save not only your progress through the objectives, b
If you do not have a backup copy of your **settings**, if anything happens to your **AAPS** smartphone you will need to start the **objectives** from the beginning again.
-Overall the **objectives** take around 6 weeks to complete (see [how long will it take?](preparing-how-long-will-it-take?) for a detailed breakdown) from configuring **AAPS** on your smartphone to "basic" hybrid closed looping (from objective 1 to objective 8), so, although you _can_ proceed up to **objective 5** using a **virtual pump** (and using some other method of insulin delivery in the meantime), having to re-complete all the **objectives** because for example, you lost your smartphone, is still something you really want to avoid.
+Overall the **objectives** take around 6 weeks to complete (see [how long will it take?](../Getting-Started/PreparingForAaps.md#how-long-will-it-take-to-set-everything-up) for a detailed breakdown) from configuring **AAPS** on your smartphone to "basic" hybrid closed looping (from objective 1 to objective 8), so, although you _can_ proceed up to **objective 5** using a **virtual pump** (and using some other method of insulin delivery in the meantime), having to re-complete all the **objectives** because for example, you lost your smartphone, is still something you really want to avoid.
-As well as progressing through the **objectives**, if you want, you can also remove your progress and [go back to an earlier objective](Objectives-go-back-in-objectives).
+As well as progressing through the **objectives**, if you want, you can also remove your progress and [go back to an earlier objective](#go-back-in-objectives).
## Objective 1: Setting up visualization and monitoring, analysing basals and ratios
@@ -29,10 +29,10 @@ As well as progressing through the **objectives**, if you want, you can also rem
If not you have to reconfigure until the basic technical setup works for **AAPS**.
-- Select the correct CGMS/FGMS in [Config Builder](../Configuration/Config-Builder.md). See [BG Source](../Configuration/BG-Source.md) for more information.
-- Select the correct Pump in [Config Builder](../Configuration/Config-Builder.md) to ensure your pump can communicate with AAPS. Select **virtual pump** if you are using a pump model with no **AAPS** driver for looping, or if you want to work through the early **objectives** while using another system for insulin delivery. See [insulin pump](../Getting-Started/Pump-Choices.md) for more information.
+- Select the correct CGMS/FGMS in [Config Builder](../Configuration/Config-Builder.md). See [BG Source](../Getting-Started/CompatiblesCgms.md) for more information.
+- Select the correct Pump in [Config Builder](../Configuration/Config-Builder.md) to ensure your pump can communicate with AAPS. Select **virtual pump** if you are using a pump model with no **AAPS** driver for looping, or if you want to work through the early **objectives** while using another system for insulin delivery. See [insulin pump](../Getting-Started/CompatiblePumps.md) for more information.
- Follow instructions in [Nightscout](../Installing-AndroidAPS/Nightscout.md) page to ensure **Nightscout** can receive and display this data.
-- Note that URL in **NSClient** must be **_without_ "/api/v1/"** at the end - see [NSClient settings in Preferences](Preferences-nsclient).
+- Note that URL in **NSClient** must be **_without_ "/api/v1/"** at the end - see [NSClient settings in Preferences](../Configuration/Preferences.md#NSClient).
Note - *You may need to wait for the next sensor glucose reading to arrive before **AAPS** will recognise it.*
@@ -77,7 +77,7 @@ From time to time, new features are added to **AAPS** which may require a new qu
## Objective 4: Starting on an open loop
-The purpose of this objective is to recognise how often **AAPS** will evaluate the basal rate's impact on glucose levels, and recommend temporary basal rate adjustments. As part of this objective, you will activate open looping for the first time, and will perform 20 proposed temporary basal rate changes manually on your pump. Furthermore, you will observe temporary and default temporary targets' impact (_e.g._ for activity or hypo treatments). If you are not familiar with setting a temporay basal rate change in **AAPS** yet, please refer to the [ACTIONS tab](Screenshots#Screenshots-action-tab).
+The purpose of this objective is to recognise how often **AAPS** will evaluate the basal rate's impact on glucose levels, and recommend temporary basal rate adjustments. As part of this objective, you will activate open looping for the first time, and will perform 20 proposed temporary basal rate changes manually on your pump. Furthermore, you will observe temporary and default temporary targets' impact (_e.g._ for activity or hypo treatments). If you are not familiar with setting a temporay basal rate change in **AAPS** yet, please refer to the [ACTIONS tab](../Getting-Started/Screenshots.md#action-tab).
Estimated time to complete this objective: **7 days**. This is a mandatory wait time. You can't proceed to the next Objective, even if you enacted all basal rate changes already.
@@ -102,11 +102,11 @@ Estimated time to complete this objective: **7 days**. This is a mandatory wait
## Objective 5: Understanding your open loop, including its temp basal recommendations
-As part of **Objective 5** you will start to understand how temporary basal recommendations are derived. This includes the [determination of basal logic](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/Understand-determine-basal.html), analyzing the impact by observing [prediction lines in AAPS OVERVIEW](Screenshots-prediction-lines)/Nightscout and looking at detailed calculations shown on your OPENAPS tab.
+As part of **Objective 5** you will start to understand how temporary basal recommendations are derived. This includes the [determination of basal logic](https://openaps.readthedocs.io/en/latest/docs/While%20You%20Wait%20For%20Gear/Understand-determine-basal.html), analyzing the impact by observing [prediction lines in AAPS OVERVIEW](../Getting-Started/Screenshots.md#prediction-lines)/Nightscout and looking at detailed calculations shown on your OPENAPS tab.
Estimated time to complete this objective: 7 days.
-This Objective requires you to determine and set your “Max U/h a temp basal can be set to” (max-basal) value as described in [OpenAPS-features](Open-APS-features#Open-APS-features-max-u-h-a-temp-basal-can-be-set-to-openaps-max-basal). This value can be set in Preferences > OpenAPS.
+This Objective requires you to determine and set your “Max U/h a temp basal can be set to” (max-basal) value as described in [OpenAPS-features](Open-APS-features.md#max-uh-a-temp-basal-can-be-set-to-openaps-max-basal). This value can be set in Preferences > OpenAPS.
Make sure this safety setting is set in both **AAPS** and your insulin pump.
You might want to set your target higher than usual until you are comfortable with the calculations and settings.
@@ -142,7 +142,7 @@ If you are open looping with a virtual pump stop here. Only click verify at the
You will still need to correct high BG values by yourself (manually with corrections by pump or pen)!
```
-As part of **Objective 6** you will close the loop and activate its Low Glucose Suspend (LGS) mode while [max IOB](Open-APS-features-maximum-total-iob-openaps-cant-go-over-openaps-max-iob) is set to zero. You have to remain in LGS mode for 5 days to complete this objective. You should use this time to check if your profile settings are accurate and don't trigger LGS events too often.
+As part of **Objective 6** you will close the loop and activate its Low Glucose Suspend (LGS) mode while [max IOB](Open-APS-features.md#maximum-total-iob-openaps-cant-go-over-openaps-max-iob) is set to zero. You have to remain in LGS mode for 5 days to complete this objective. You should use this time to check if your profile settings are accurate and don't trigger LGS events too often.
Estimated time to complete this objective: 5 days.
@@ -168,7 +168,7 @@ This means that when you are on Objective 6, if sensor glucose levels are droppi
(Objectives-objective-7-tuning-the-closed-loop-raising-max-iob-above-0-and-gradually-lowering-bg-targets)=
## Objective 7: Tuning the closed loop, raising maxIOB above 0 and gradually lowering BG targets
-To complete **Objective 7** you have to close your loop and raise your [maxIOB](Open-APS-features-maximum-total-iob-openaps-cant-go-over-openaps-max-iob). maxIOB was zeroed out automatically in **objective 6**. This is now reverted. **AAPS** will start to use your defined maxIOB value to correct high glucose values.
+To complete **Objective 7** you have to close your loop and raise your [maxIOB](Open-APS-features.md#maximum-total-iob-openaps-cant-go-over-openaps-max-iob). maxIOB was zeroed out automatically in **objective 6**. This is now reverted. **AAPS** will start to use your defined maxIOB value to correct high glucose values.
Estimated time to complete this objective: 1 day.
@@ -197,8 +197,8 @@ Estimated time to complete this objective: 7 days.
In this objective you will tackle and use "Super Micro Bolus (SMB)" as one core functionality. After working through the mandatory readings you will have a good understanding of what SMBs are, how these work, reasonable starting point with SMBs and why basal is set to zero temporarily after SMBs are given (zero-temping). Estimated time to complete this objective: 28 days.
-- The [SMB section in this documentation](Open-APS-features-super-micro-bolus-smb) and [oref1 coverage in the openAPSdocs](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html) are must-reads to understand SMB and the concept of zero-temping.
-- Once done, you [raise maxIOB](Open-APS-features-maximum-total-iob-openaps-cant-go-over-openaps-max-iob) to get SMBs working well. maxIOB now includes all IOB, not just accumulated basal. This threshold pauses SMBs until IOB drops below this value (_e.g._ maxIOB is set to 7 U and a bolus of 8 U is given to cover a meal: SMBs will be paused and not given unless IOB drops below 7 U). A good start is setting maxIOB = average mealbolus + 3x max daily basal (max daily basal = the maximum hourly value in any time segment of the day - see [objective 7](Objectives-objective-7-tuning-the-closed-loop-raising-max-iob-above-0-and-gradually-lowering-bg-targets) as reference)
+- The [SMB section in this documentation](Open-APS-features.md#super-micro-bolus-smb) and [oref1 coverage in the openAPSdocs](https://openaps.readthedocs.io/en/latest/docs/Customize-Iterate/oref1.html) are must-reads to understand SMB and the concept of zero-temping.
+- Once done, you [raise maxIOB](Open-APS-features.md#maximum-total-iob-openaps-cant-go-over-openaps-max-iob) to get SMBs working well. maxIOB now includes all IOB, not just accumulated basal. This threshold pauses SMBs until IOB drops below this value (_e.g._ maxIOB is set to 7 U and a bolus of 8 U is given to cover a meal: SMBs will be paused and not given unless IOB drops below 7 U). A good start is setting maxIOB = average mealbolus + 3x max daily basal (max daily basal = the maximum hourly value in any time segment of the day - see [objective 7](#objective-7-tuning-the-closed-loop-raising-maxiob-above-0-and-gradually-lowering-bg-targets) as reference)
- Change "min_5m_carbimpact"-parameter (Preferences > Absorbtion settings > min_5m_carbimpact) to 8 as you move from an OpenAPS AMA algorithm to OpenAPS SMB. For AMAs the default value is 3. Read more about this setting [here](../Configuration/Preferences.md#min_5m_carbimpact)
(Objectives-objective-10-automation)=
@@ -240,4 +240,4 @@ If you want to go back in **objectives** progress for whatever reason you can do
## Objectives in Android APS before version 3.0
-One objective was removed when **AAPS** version 3.0 was released. Users of Android APS version 2.8.2.1 who are on older Android software (_i.e._ earlier than version 9) will be using an older set of Objectives which can be found [here](../Usage/Objectives_old.md).
+One objective was removed when **AAPS** version 3.0 was released. Users of Android APS version 2.8.2.1 who are on older Android software (_i.e._ earlier than version 9) will be using an older set of Objectives which can be found [here].
diff --git a/docs/EN/Usage/troubleshooting.md b/docs/EN/Usage/troubleshooting.md
index 3874a0302f6e..38b1e88efa51 100644
--- a/docs/EN/Usage/troubleshooting.md
+++ b/docs/EN/Usage/troubleshooting.md
@@ -2,13 +2,13 @@
You can find troubleshooting info on many pages in the wiki. This page is a collection of links to help you find the information to solve your problem.
-Additional useful information might also be available in the [FAQ](../Getting-Started/FAQ.html).
+Additional useful information might also be available in the [FAQ](../Getting-Started/FAQ.md).
## AAPS app
### Building & updating
-* [Lost keystore](troubleshooting_androidstudio-lost-keystore)
+* [Lost keystore](../Installing-AndroidAPS/troubleshooting_androidstudio.md#lost-keystore)
* [Troubleshooting AndroidStudio](../Installing-AndroidAPS/troubleshooting_androidstudio.md)
### Settings
@@ -16,18 +16,18 @@ Additional useful information might also be available in the [FAQ](../Getting-St
-* [Pump - data from different pump](../Installing-AndroidAPS/update3_0.html#failure-message-data-from-different-pump)
+* [Pump - data from different pump](../Installing-AndroidAPS/update3_0.md#failure-message-data-from-different-pump)
-* [Nightscout Client](../Usage/Troubleshooting-NSClient.html)
+* [Nightscout Client](../Usage/Troubleshooting-NSClient.md)
### Usage
-* [Wrong carb values](COB-calculation-detection-of-wrong-cob-values)
+* [Wrong carb values](../Usage/COB-calculation.md#detection-of-wrong-cob-values)
-* [SMS commands](SMS-Commands-troubleshooting)
+* [SMS commands](../Children/SMS-Commands.md#troubleshooting)
### Frequent bluetooth connection problems
@@ -85,27 +85,27 @@ Here are examples how to find them on specific android phones.
## CGM
-* [General](GeneralCGMRecommendation-troubleshooting)
-* [Dexcom G6](DexcomG6-troubleshooting-g6)
-* [Libre 3](Libre3-experiences-and-troubleshooting)
-* [Libre 2](Libre2-experiences-and-troubleshooting)
-* [xDrip - no CGM data](xdrip-identify-receiver)
-* [xDrip - Dexcom troubleshooting](xdrip-troubleshooting-dexcom-g5-g6-and-xdrip)
+* [General](../CompatibleCgms/GeneralCGMRecommendation.md#troubleshooting)
+* [Dexcom G6](../CompatibleCgms/DexcomG6.md#troubleshooting-g6-and-one)
+* [Libre 3](../CompatibleCgms/Libre3.md#experiences-and-troubleshooting)
+* [Libre 2](../CompatibleCgms/Libre2.md#experiences-and-troubleshooting)
+* [xDrip - no CGM data](../CompatibleCgms/xDrip.md#identify-receiver)
+* [xDrip - Dexcom troubleshooting](../CompatibleCgms/xDrip.md#troubleshooting-dexcom-g5g6-and-xdrip)
## Pumps
-* [DanaRS](DanaRS-Insulin-Pump-dana-rs-specific-errors)
-* [Accu-Chek Combo general](Accu-Chek-Combo-Tips-for-Basic-usage)
-* [Accu-Chek Combo + Ruffy](Accu-Chek-Combo-Pump-why-pairing-with-the-pump-does-not-work-with-the-app-ruffy)
-* [Accu-Chek Insight](Accu-Chek-Insight-Pump-insight-specific-errors)
-* [Medtronic + RileyLink](MedtronicPump-what-to-do-if-i-loose-connection-to-rileylink-and-or-pump)
+* [DanaRS](../CompatiblePumps/DanaRS-Insulin-Pump.md#dana-rs-specific-errors)
+* [Accu-Chek Combo general](../Usage/Accu-Chek-Combo-Tips-for-Basic-usage.md)
+* [Accu-Chek Combo + Ruffy](../CompatiblePumps/Accu-Chek-Combo-Pump.md#why-pairing-with-the-pump-does-not-work-with-the-app-ruffy)
+* [Accu-Chek Insight](../CompatiblePumps/Accu-Chek-Insight-Pump.md#insight-specific-errors)
+* [Medtronic + RileyLink](../CompatiblePumps/MedtronicPump.md#what-to-do-if-i-loose-connection-to-rileylink-andor-pump)
## Phones
-* [Jelly](../Usage/jelly.md)
-* [Huawei bluetooth & battery optimization](../Usage/huawei.md)
+* [Jelly](../CompatiblePhones/Jelly.md)
+* [Huawei bluetooth & battery optimization](../CompatiblePhones/Huawei.md)
## Smartwatches
-* [Troubleshooting Wear app](Watchfaces-troubleshooting-the-wear-app)
+* [Troubleshooting Wear app](../Configuration/Watchfaces.md#troubleshooting-the-wear-app)
* [Sony Smartwatch 3](../Usage/SonySW3.md)
diff --git a/docs/EN/index.md b/docs/EN/index.md
index e6c453900a6a..abb1af317989 100644
--- a/docs/EN/index.md
+++ b/docs/EN/index.md
@@ -10,7 +10,7 @@ This documentation explains how to setup and use **AAPS**. You can navigate thro
Section 2) "Getting Started", the [Introduction](Getting-Started/Introduction.md) explains the general concept of what an artificial pancreas system (APS) is designed to do. It outlines the background of looping in general, why **AAPS** was developed, compares **AAPS** to other systems, and addresses safety. It gives suggestions about how to talk to your clinical team about **AAPS**, explains why you need to build the **AAPS** app yourself rather than just downloading it, and gives an overview of the typical connectivity of an **AAPS** system. It also addresses accessibility, and who is likely to benefit from **AAPS**.
-[Preparing for AAPS](preparing.md) gives more detail about safety considerations, and the phones, CGMs (Continuous Glucose Monitors) and insulin pumps which are compatible with **AAPS**. It gives an overview of the process you will go through, and provides an approximate timeline for gaining full functionality of **AAPS**. This section gets you technically prepared to assemble your **AAPS** setup as quickly and efficiently as possible. The subsection [CGM Configuration](Configuration/BG-Source.md) explains how to optimse CGM setup and what smoothing options are best.
+[Preparing for AAPS](./Getting-Started/PreparingForAaps.md) gives more detail about safety considerations, and the phones, CGMs (Continuous Glucose Monitors) and insulin pumps which are compatible with **AAPS**. It gives an overview of the process you will go through, and provides an approximate timeline for gaining full functionality of **AAPS**. This section gets you technically prepared to assemble your **AAPS** setup as quickly and efficiently as possible. The subsection [CGM Configuration](./Getting-Started/CompatiblesCgms.md) explains how to optimse CGM setup and what smoothing options are best.
Now that you have a solid understanding of the process, you can start assembling your **AAPS** loop. Section **3) Setting up AAPS** contains step-by-step instructions to do this. It covers choosing and [setting up your reporting server](Installing-AndroidAPS/setting-up-the-reporting-server.md) (Nightscout or Tidepool) so you can review and share your data, getting your computer ready for building the AAPS app, building the AAPS app and transferring the AAPS app to your phone. It also covers setting up the **AAPS** app using the setup Wizard, linking it with your CGM app, and either a real or virtual insulin pump, as well as linking **AAPS** to your reporting server.
You are then slowly introduced to the full usage of what **AAPS** has to offer via a safe and carefully calibrated step-by-step process designed to make sure that you/your child are thoroughly familiar and comfortable navigating all the different levels and menu configurations before graduating on the next phase, commonly referred to as the next "Objective", until you are have enough experience to begin using the more advanced options available within the app.
@@ -61,16 +61,16 @@ Do not use **AAPS** if you take SGLT-2 inhibitors (gliflozins), as they lower bl
```{toctree}
:caption: 1) Change language
-Change language <./changelanguage.md>
+Change language <./ChangeLanguage/ChangeLanguage.md>
```
```{toctree}
:caption: 2) Getting started
Introduction to AAPS <./Getting-Started/Introduction.md>
-Preparing for AAPS
-Compatible pumps <./Getting-Started/Pump-Choices.md>
-Compatible CGMs <./Configuration/BG-Source.md>
-Compatible phones <./Hardware/Phoneconfig.md>
+Preparing for AAPS <./Getting-Started/PreparingForAaps.md>
+Compatible pumps <./Getting-Started/CompatiblePumps.md>
+Compatible CGMs <./Getting-Started/CompatiblesCgms.md>
+Compatible phones <./Getting-Started/Phones.md>
```
```{toctree}
@@ -146,13 +146,10 @@ Help! My AAPS phone is broken/stolen/lost
Glossary <./Getting-Started/Glossary.md>
AAPS Screens <./Getting-Started/Screenshots.md>
Your AAPS profile
-Compatible pumps <./Getting-Started/Pump-Choices.md>
Accu-Chek Combo tips for basic usage <./Usage/Accu-Chek-Combo-Tips-for-Basic-usage.md>
-Compatible CGMs <./Configuration/BG-Source.md>
-Compatible phones <./Hardware/Phoneconfig.md>
Operation of Wear AAPS on a Smartwatch <./Configuration/Watchfaces.md>
How to customise your AAPS watchface <./Usage/Custom_Watchface_Reference.md>
-xDrip Settings <./Configuration/xdrip.md>
+xDrip Settings <./CompatibleCgms/xDrip.md>
Autotune <./Usage/autotune.md>
```