dotnet · adegeo · Aug 3, 2021 · Aug 3, 2021
diff --git a/docs/essentials/accelerometer.md b/docs/essentials/accelerometer.md
@@ -14,7 +14,7 @@ The **Accelerometer** class lets you monitor the device's accelerometer sensor,
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Accelerometer
 
@@ -81,7 +81,7 @@ Examples:
 
 - When the device lies flat on a table and is pushed toward the sky with an acceleration of A m/s^2, the acceleration value is equal to A+9.81 which corresponds to the acceleration of the device (+A m/s^2) minus the force of gravity (-9.81 m/s^2) and normalized in G.
 
-[!include[](~/essentials/includes/sensor-speed.md)]
+[!INCLUDE [sensor-speed](includes/sensor-speed.md)]
 
 ## API
 
@@ -92,4 +92,4 @@ Examples:
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Accelerometer-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/app-actions.md b/docs/essentials/app-actions.md
@@ -13,7 +13,7 @@ The **AppActions** class lets you create and respond to app shortcuts from the a
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **AppActions** functionality the following platform specific setup is required.
 

diff --git a/docs/essentials/app-information.md b/docs/essentials/app-information.md
@@ -14,7 +14,7 @@ The **AppInfo** class provides information about your application.
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using AppInfo
 
@@ -93,4 +93,4 @@ App information is taken from the `Package.appxmanifest` for the following field
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/App-Information-Essential-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/app-theme.md b/docs/essentials/app-theme.md
@@ -14,7 +14,7 @@ The **RequestedTheme** API is part of the [`AppInfo`](app-information.md) class
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using RequestedTheme
 
@@ -75,4 +75,4 @@ You can read more on the [UWP Requested Theme Documentation](/uwp/api/windows.ui
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Theme-Detection-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/barometer.md b/docs/essentials/barometer.md
@@ -13,7 +13,7 @@ The **Barometer** class lets you monitor the device's barometer sensor, which me
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Barometer
 
@@ -66,7 +66,7 @@ public class BarometerTest
 }
 ```
 
-[!include[](~/essentials/includes/sensor-speed.md)]
+[!INCLUDE [sensor-speed](includes/sensor-speed.md)]
 
 ## Platform Implementation Specifics
 

diff --git a/docs/essentials/battery.md b/docs/essentials/battery.md
@@ -14,7 +14,7 @@ The **Battery** class lets you check the device's battery information and monito
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **Battery** functionality the following platform specific setup is required.
 
@@ -184,4 +184,4 @@ No platform differences.
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Battery-Essential-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/clipboard.md b/docs/essentials/clipboard.md
@@ -14,7 +14,7 @@ The **Clipboard** class lets you copy and paste text to the system clipboard bet
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Clipboard
 
@@ -72,4 +72,4 @@ public class ClipboardTest
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Clipboard-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/color-converters.md b/docs/essentials/color-converters.md
@@ -14,7 +14,7 @@ The **ColorConverters** class in Xamarin.Essentials provides several helper meth
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Color Converters
 
@@ -84,4 +84,4 @@ The `ToSystemColor` method applies to Android.Graphics.Color, UIKit.UIColor, and
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Color-Converters-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/compass.md b/docs/essentials/compass.md
@@ -14,7 +14,7 @@ The **Compass** class lets you monitor the device's magnetic north heading.
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Compass
 
@@ -66,7 +66,7 @@ public class CompassTest
 }
 ```
 
-[!include[](~/essentials/includes/sensor-speed.md)]
+[!INCLUDE [sensor-speed](includes/sensor-speed.md)]
 
 ## Platform Implementation Specifics
 
@@ -99,4 +99,4 @@ This is only applied on the Android platform, and the parameter is ignored on iO
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Compass-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/connectivity.md b/docs/essentials/connectivity.md
@@ -14,7 +14,7 @@ The **Connectivity** class lets you monitor for changes in the device's network
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **Connectivity** functionality the following platform specific setup is required.
 
@@ -117,4 +117,4 @@ It is important to note that it is possible that `Internet` is reported by `Netw
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Connectivity-Essential-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/contacts.md b/docs/essentials/contacts.md
@@ -13,7 +13,7 @@ The **Contacts** class lets a user pick a contact and retrieve information about
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **Contacts** functionality the following platform specific setup is required.
 

diff --git a/docs/essentials/detect-shake.md b/docs/essentials/detect-shake.md
@@ -14,7 +14,7 @@ The **[Accelerometer](accelerometer.md)** class lets you monitor the device's ac
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Detect Shake
 
@@ -65,7 +65,7 @@ public class DetectShakeTest
 }
 ```
 
-[!include[](~/essentials/includes/sensor-speed.md)]
+[!INCLUDE [sensor-speed](includes/sensor-speed.md)]
 
 ## Implementation Details
 
@@ -80,4 +80,4 @@ The detect shake API uses raw readings from the accelerometer to calculate accel
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Detect-Shake-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/device-display.md b/docs/essentials/device-display.md
@@ -14,7 +14,7 @@ The **DeviceDisplay** class provides information about the device's screen metri
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using DeviceDisplay
 
@@ -106,4 +106,4 @@ No differences.
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Device-Display-Information-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/device-information.md b/docs/essentials/device-information.md
@@ -14,7 +14,7 @@ The **DeviceInfo** class provides information about the device the application i
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using DeviceInfo
 
@@ -90,4 +90,4 @@ iOS does not expose an API for developers to get the model of the specific iOS d
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Device-Information-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/email.md b/docs/essentials/email.md
@@ -48,7 +48,7 @@ No platform differences.
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 > [!TIP]
 > To use the Email API on iOS you must run it on a physical device, else an exception will be thrown.
@@ -141,4 +141,4 @@ Not all email clients support sending attachments. See [documentation](/windows/
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Email-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/file-picker.md b/docs/essentials/file-picker.md
@@ -13,7 +13,7 @@ The **FilePicker** class lets a user pick a single or multiple files from the de
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **FilePicker** functionality the following platform specific setup is required.
 
@@ -105,7 +105,7 @@ var options = new PickOptions
 
 If you desire your user to pick multiple files you can call the `FilePicker.PickMultipleAsync()` method. It also takes in `PickOptions` as a parameter to specify additional information. The results are the same as `PickAsync`, but instead of a single `FileResult` an `IEnumerable<FileResult>` is returned that can be iterated over.
 
-[!include[](~/essentials/includes/tip-file-result.md)]
+[!INCLUDE [tip-file-result](includes/tip-file-result.md)]
 
 ## Platform Differences
 

diff --git a/docs/essentials/file-system-helpers.md b/docs/essentials/file-system-helpers.md
@@ -14,7 +14,7 @@ The **FileSystem** class contains a series of helpers to find the application's
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using File System Helpers
 
@@ -85,4 +85,4 @@ Add any file into the root in the UWP project and mark the Build Action as **Con
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/File-System-Helpers-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/flashlight.md b/docs/essentials/flashlight.md
@@ -14,7 +14,7 @@ The **Flashlight** class has the ability to turn on or off the device's camera f
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **Flashlight** functionality the following platform specific setup is required.
 
@@ -47,7 +47,7 @@ By adding these permissions [Google Play will automatically filter out devices](
 [assembly: UsesFeature("android.hardware.camera.autofocus", Required = false)]
 ```
 
-[!include[](~/essentials/includes/android-permissions.md)]
+[!INCLUDE [android-permissions](includes/android-permissions.md)]
 
 # [iOS](#tab/ios)
 
@@ -125,4 +125,4 @@ A camera surface texture is created to turn on or off the `FlashMode` of the cam
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Flashlight-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/geocoding.md b/docs/essentials/geocoding.md
@@ -14,7 +14,7 @@ The **Geocoding** class provides APIs to geocode a placemark to a positional coo
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **Geocoding** functionality the following platform specific setup is required.
 
@@ -125,4 +125,4 @@ The [`Location`](xref:Xamarin.Essentials.Location) and [`LocationExtensions`](xr
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Geocoding-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/geolocation.md b/docs/essentials/geolocation.md
@@ -14,7 +14,7 @@ The **Geolocation** class provides APIs to retrieve the device's current geoloca
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **Geolocation** functionality, the following platform-specific setup is required:
 
@@ -60,7 +60,7 @@ Or directly into your **AndroidManifest.xml**:
 
 If it recommended to read [Android documentation on background location updates](https://developer.android.com/training/location/permissions) as there are many restrictions that need to be considered.
 
-[!include[](~/essentials/includes/android-permissions.md)]
+[!INCLUDE [android-permissions](includes/android-permissions.md)]
 
 # [iOS](#tab/ios)
 
@@ -270,4 +270,4 @@ On UWP, altitude is returned in meters. See the [AltitudeReferenceSystem](/uwp/a
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Geolocation-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]
diff --git a/docs/essentials/gyroscope.md b/docs/essentials/gyroscope.md
@@ -13,7 +13,7 @@ The **Gyroscope** class lets you monitor the device's gyroscope sensor which is
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Gyroscope
 
@@ -66,7 +66,7 @@ public class GyroscopeTest
 }
 ```
 
-[!include[](~/essentials/includes/sensor-speed.md)]
+[!INCLUDE [sensor-speed](includes/sensor-speed.md)]
 
 ## API
 

diff --git a/docs/essentials/haptic-feedback.md b/docs/essentials/haptic-feedback.md
@@ -13,7 +13,7 @@ The **HapticFeedback** class lets you control haptic feedback on device.
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 To access the **HapticFeedback** functionality the following platform specific setup is required.
 

diff --git a/docs/essentials/launcher.md b/docs/essentials/launcher.md
@@ -14,7 +14,7 @@ The **Launcher** class enables an application to open a URI by the system. This
 
 ## Get started
 
-[!include[](~/essentials/includes/get-started.md)]
+[!INCLUDE [get-started](includes/get-started.md)]
 
 ## Using Launcher
 
@@ -93,7 +93,7 @@ await Launcher.OpenAsync(new OpenFileRequest
 
 ## Presentation Location When Opening Files
 
-[!include[](~/essentials/includes/ios-PresentationSourceBounds.md)]
+[!INCLUDE [ios-PresentationSourceBounds](includes/ios-PresentationSourceBounds.md)]
 
 ## Platform Differences
 
@@ -124,4 +124,4 @@ No platform differences.
 
 > [!Video https://channel9.msdn.com/Shows/XamarinShow/Launcher-XamarinEssentials-API-of-the-Week/player]
 
-[!include[](~/essentials/includes/xamarin-show-essentials.md)]
+[!INCLUDE [xamarin-show-essentials](includes/xamarin-show-essentials.md)]