Reorganize getting started section

docs/EN/changelanguage.md → 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.
 ```
 
-![Open language menu](images/documentation_language_menu.png){w=350px align=center}
+![Open language menu](../images/documentation_language_menu.png){w=350px align=center}

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.

docs/EN/Hardware/CgmNightscoutUpload.md → 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).

docs/EN/Hardware/DexcomG5.md → 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

docs/EN/Hardware/DexcomG6.md → 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
 

docs/EN/Hardware/DexcomG7.md → 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
 
 ![G7 english](../images/6fe30b84-227a-4bae-a9a5-527cee341dbf.png)
 
-```{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,12 +41,12 @@ 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) 
 
 -   Download and install xDrip+: [xDrip](https://github.com/NightscoutFoundation/xDrip) 
 - 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) 

docs/EN/Hardware/Eversense.md → 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.

docs/EN/Hardware/GeneralCGMRecommendation.md → 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).
 ![Negative sensor age](../images/Troubleshooting_SensorAge.png)
 
 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.

docs/EN/Hardware/Libre1.md → 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).
 

docs/EN/Hardware/Libre2.md → 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

docs/EN/Hardware/Libre3.md → 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.
 

docs/EN/Usage/Smoothing-Blood-Glucose-Data.md → 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).

docs/EN/Configuration/xdrip.md → 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