Various README improvements (#334)

Author: Ellerbach

samples/1-Wire/README.md

@@ -2,6 +2,8 @@
 
 Shows how to use the [nanoFramework.Device.OneWire](http://docs.nanoframework.net/api/nanoFramework.Device.OneWire.html) API to read and write from/to a 1-Wire device.
 
+The sample is [located here](./).
+
 ## Hardware requirements
 
 - A .NET nanoFramework target with 1-Wire capability enabled in the firmware for example a STM32F407_DISCO or any of the ESP32 targets.

samples/ADC/README.md

@@ -2,6 +2,8 @@
 
 Shows how to use the [System.Devices.Adc](http://docs.nanoframework.net/api/System.Device.Adc.html) API to read external voltages using an ADC.
 
+The sample is [located here](./Program.cs).
+
 ## Hardware requirements
 
 Any hardware device running a nanoFramework image.
@@ -31,5 +33,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/AMQP/Azure-IoT-Hub/README.md

@@ -1,6 +1,8 @@
 # 🌶️🌶️ -Azure AMQP sample
 
-Shows how to use AMQP.Net Lite library with Azure.
+Shows how to use AMQP.Net Lite library.
+
+The sample is [located here](./Program.cs).
 
 ## Hardware requirements
 
@@ -16,7 +18,8 @@ To use a secured (TLS) connection to Azure IoT Hub the following is required:
 
 1. Generate an SAS Token for your device. [Azure IoT Explorer](https://github.com/Azure/azure-iot-explorer) it's a convenient tool to do this for you.
 After setting up the access to you IoT Hub, navigate to the device, enter the desired parameters and generate the SAS Token (see the print screen below).
-![](azure-iot-explorer-sas.png) 
+
+![Azure IoT Explorer](../azure-iot-explorer-sas.png)
 
 ### Reference
 
@@ -41,5 +44,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/AMQP/Azure-ServiceBus-Sender/README.md

@@ -1,6 +1,8 @@
 # 🌶️🌶️ - Azure Service Bus AMQP sample
 
-Shows how to use AMQP.Net Lite library with Azure Servic eBus.
+Shows how to use Shows how to use AMQP.Net Lite library with Azure Service Bus.
+
+The sample is [located here](./Program.cs).
 
 ## Hardware requirements
 
@@ -16,7 +18,8 @@ To use a secured (TLS) connection to Azure IoT Hub the following is required:
 
 1. Generate an SAS Token for your device. [Azure IoT Explorer](https://github.com/Azure/azure-iot-explorer) it's a convenient tool to do this for you.
 After setting up the access to you IoT Hub, navigate to the device, enter the desired parameters and generate the SAS Token (see the print screen below).
-![](azure-iot-explorer-sas.png) 
+
+![Azure IoT Explorer](../azure-iot-explorer-sas.png)
 
 ### Reference
 
@@ -41,5 +44,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/AMQP/README.md

@@ -2,13 +2,7 @@
 
 Shows how to use AMQP.Net Lite library.
 
-> **Note:** This sample is part of a large collection of nanoFramework feature samples.
-> If you are unfamiliar with Git and GitHub, you can download the entire collection as a
-> [ZIP file](https://github.com/nanoframework/Samples/archive/main.zip), but be
-> sure to unzip everything to access any shared dependencies.
-<!-- For more info on working with the ZIP file, 
-> the samples collection, and GitHub, see [Get the UWP samples from GitHub](https://aka.ms/ovu2uq). 
-> For more samples, see the [Samples portal](https://aka.ms/winsamples) on the Windows Dev Center.  -->
+The sample pack is [located here](./).
 
 ## Hardware requirements
 
@@ -24,7 +18,8 @@ To use a secured (TLS) connection to Azure IoT Hub the following is required:
 
 1. Generate an SAS Token for your device. [Azure IoT Explorer](https://github.com/Azure/azure-iot-explorer) it's a convenient tool to do this for you.
 After setting up the access to you IoT Hub, navigate to the device, enter the desired parameters and generate the SAS Token (see the print screen below).
-![](azure-iot-explorer-sas.png) 
+
+![Azure IoT Explorer](azure-iot-explorer-sas.png)
 
 ### Reference
 
@@ -49,5 +44,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/AzureMQTTTwinsBMP280Sleep/README.md

@@ -2,6 +2,8 @@
 
 Shows how to use M2Mqtt library with Azure IoT measuring a BMP280 sensor. This leverages the [nanoFramework.IoT.Device](https://github.com/nanoframework/nanoFramework.IoT.Device) repository.
 
+The sample is [located here](./).
+
 ## Hardware requirements
 
 An hardware device with networking capabilities running a nanoFramework image. 
@@ -40,5 +42,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 **Important**: You can debug this sample only for one cycle as the device will very quickly go to sleep. If you want to debug, comment the part where it goes to sleep and replace with and infinite thread sleep timeout or a loop to once of the previous part of the code.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/AzureSDK/AzureEdgeOta/README.md

@@ -4,6 +4,8 @@ This examples is a complete code Over the Air (OTA) example using Azure IoT. You
 
 ![Architecture](architecture.png)
 
+The sample is [located here](./).
+
 ## Hardware requirements
 
 An hardware device with networking capabilities running a nanoFramework image. 

samples/AzureSDK/AzureIoTPnP/README.md

@@ -4,6 +4,8 @@ This sample uses the .NET nanoFramework Azure IoT Plug & Play. You can find it h
 
 Note: the samples include the Azure IoT certificate. You can as well upload it into your device as explained in the [main readme](https://github.com/nanoframework/nanoFramework.Azure.Devices).
 
+The sample is [located here](./).
+
 ## Testing the sample
 
 This sample uses a specific DTDL as an example, [you'll find it here](https://github.com/Azure/iot-plugandplay-models/blob/main/dtmi/com/example/thermostat-1.json). The Model ID is `dtmi:com:example:Thermostat;1`. This is what is going to be used in this sample.

samples/AzureSDK/AzureSDK/README.md

@@ -4,6 +4,8 @@ This sample uses the .NET nanoFramework Azure IoT Hub SDK with MQTT protocol. Yo
 
 Note: the samples include the Azure IoT certificate. You can as well upload it into your device as explained in the [main readme](https://github.com/nanoframework/nanoFramework.Azure.Devices).
 
+The sample is [located here](./).
+
 ## Testing the sample
 
 This sample uses a very popular BMP280 sensor. If you don't have this sensor, there is part of the code that is marked as comment. Just comment those lines and uncomment one of the line. This will simply simulate the sensor with static data.

samples/AzureSDK/AzureSDKBasic/README.md

@@ -8,6 +8,8 @@ You can test this sample by enabling and disabling the device in Azure IoT. You
 
 ![telemetry example](./output.png)
 
+The sample is [located here](./).
+
 ## Hardware requirements
 
 An hardware device with networking capabilities running a nanoFramework image.

samples/AzureSDK/AzureSDKBasicFullyManaged/README.md

@@ -8,6 +8,8 @@ You can test this sample by enabling and disabling the device in Azure IoT. You
 
 ![telemetry example](./output.png)
 
+The sample is [located here](./).
+
 ## Hardware requirements
 
 You need one modem supporting MQTT abstraction that is supported to use, see [current list here](https://github.com/nanoframework/nanoFramework.IoT.Device/tree/develop/devices/AtModem#documentation).

samples/AzureSDK/AzureSDKSensorCertificate/Readme.md

@@ -11,6 +11,8 @@ Every 3 seconds application reads temperature value from BMP280 sensor and turns
 
 > **Note**: this sample requires a good understanding on how certificate authentication works. And how to set them up properly in Azure IoT.
 
+The sample is [located here](./).
+
 ## Getting Started with nanoFramework
 
 * [Getting Started Guide for managed code (C#)](https://docs.nanoframework.net/content/getting-started-guides/getting-started-managed.html)

samples/AzureSDK/AzureSDKSleepBMP280/README.md

@@ -2,6 +2,8 @@
 
 Shows how to use the Azure IoT SDK library measuring a BMP280 sensor. This leverages the [nanoFramework.IoT.Device](https://github.com/nanoframework/nanoFramework.IoT.Device) repository and [Azure SDK](https://github.com/nanoframework/nanoFramework.Azure.Devices).
 
+The sample is [located here](./).
+
 ## Hardware requirements
 
 An hardware device with networking capabilities running a nanoFramework image. 

samples/AzureSDK/DpsSampleApp/README.md

@@ -8,6 +8,8 @@ The documentation can be found [here](https://docs.microsoft.com/en-us/azure/iot
 
 Refer to the main [.NET nanoFramework SDK](https://github.com/nanoframework/nanoFramework.Azure.Devices) to understand the usage.
 
+The sample is [located here](./).
+
 ## Usage
 
 The device **must** be connected to the Internet and have a valid date and time.

samples/AzureSDK/README.md

@@ -4,10 +4,10 @@ These samples are using [Azure IoT Hub SDK](https://github.com/nanoframework/nan
 
 ## Samples
 
-* [🌶️🌶️ -  Azure IoT Hub SDK with MQTT protocol](AzureSDK)
-* [🌶️🌶️🌶️ -  Complete Azure MQTT sample using BMP280 sensor](AzureSDKSleepBMP280)
-* [🌶️🌶️ -  Azure IoT Device Provisioning Service (DPS) example](DpsSampleApp)
-* [🌶️🌶️🌶️ -  Azure SDK with X.509 CA Signed certificate sample using BMP280 Sensor](AzureSDKSensorCertificate)
+- [🌶️🌶️ -  Azure IoT Hub SDK with MQTT protocol](AzureSDK)
+- [🌶️🌶️🌶️ -  Complete Azure MQTT sample using BMP280 sensor](AzureSDKSleepBMP280)
+- [🌶️🌶️ -  Azure IoT Device Provisioning Service (DPS) example](DpsSampleApp)
+- [🌶️🌶️🌶️ -  Azure SDK with X.509 CA Signed certificate sample using BMP280 Sensor](AzureSDKSensorCertificate)
 
 ## Build the sample
 
@@ -28,5 +28,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/Blinky/README.md

@@ -2,6 +2,8 @@
 
 Shows how to use the [System.Device.Gpio](http://docs.nanoframework.net/api/System.Device.Gpio.html) API to set GPIO pins.
 
+The sample is [located here](./Blinky/Program.cs).
+
 ## Hardware requirements
 
 Any hardware device running a nanoFramework image.
@@ -33,5 +35,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/Bluetooth/BluetoothBeacon/README.md

@@ -1,4 +1,4 @@
-# 🌶️🌶️🌶️ -  Create an IBeacon: 
+# 🌶️🌶️🌶️ -  Create an IBeacon
 
 This shows how to create a Bluetooth iBeacon.
 The sample contains a **Beacon class** which does hard work and can be easily used in other applications.
@@ -7,3 +7,5 @@ You will be able to see iBeacon advertisements in the relevant applications.
 Suitable Phone applications: "LightBlue" or "nRF Connect"
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/BluetoothBeacon/category.txt

@@ -0,0 +1,2 @@
+esp32
+ble

samples/Bluetooth/BluetoothLESample1/README.md

@@ -15,3 +15,5 @@ You will be able to connect to the service and read values or subscribe to be No
 Suitable Phone apps: "LightBlue" or "nRF Connect"
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/BluetoothLESample2/README.md

@@ -18,3 +18,5 @@ The 2nd Characteristic allows writes but requires to be paired for the read.
 The 3rd Characteristic allows writes but requires to be paired with authentication for the read.
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/BluetoothLESample3/README.md

@@ -28,3 +28,5 @@ This sample class includes these 4 but other types can easily added to class. Mu
 The sample shows 3 Temperatures (Instantaneous, Maximum, Minimum) added to service and a humidity sensor.
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/BluetoothLESerial/README.md

@@ -1,6 +1,6 @@
 # 🌶️ - Bluetooth Low Energy Serial profile sample
 
-Shows how to use the Serial Protocol Profile APIs included in the [NanoFramework.Device.Bluetooth](http://docs.nanoframework.net/api/NanoFramework.Device.Bluetooth.html).   
+Shows how to use the Serial Protocol Profile APIs included in the [NanoFramework.Device.Bluetooth](http://docs.nanoframework.net/api/NanoFramework.Device.Bluetooth.html).
 
 The sample allows a Bluetooth Terminal program to connect and send/receive text messages. There are a number of applications on both Android and IOS
 that will work.
@@ -9,7 +9,9 @@ The device should be seen as "nanoFrameworkSerial" when scanning for the device.
 
 Send device 'help' to get information on what messages it will respond to.
 
-This sample is a example of what you could do to provision your device with required data like wifi credentials, name etc. 
+This sample is a example of what you could do to provision your device with required data like wifi credentials, name etc.
+
+The sample is [located here](./Program.cs).
 
 ## Hardware requirements
 
@@ -45,5 +47,4 @@ The next steps depend on whether you just want to deploy the sample or you want
 - To debug the sample and then run it, press F5 or select `Debug > Start Debugging`.
 
 > **Important**: Before deploying or running the sample, please make sure your device is visible in the Device Explorer.
-
 > **Tip**: To display the Device Explorer, go to Visual Studio menus: `View > Other Windows > Device Explorer`.

samples/Bluetooth/BroadcastValues/README.md

@@ -12,3 +12,5 @@ You will be able see advertisements from device with ManufacterData value changi
 Suitable Phone applications: "LightBlue" or "nRF Connect"
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/BroadcastValues/category.txt

@@ -0,0 +1 @@
+ble

samples/Bluetooth/Central1/README.md

@@ -1,7 +1,9 @@
-# 🌶️🌶️ - Bluetooth Low energy: Watch for Bluetooth Advertisments
+# 🌶️🌶️ - Bluetooth Low energy: Watch for Bluetooth Advertisements
 
-This sample shows how to create a BluetoothLEAdvertisementWatcher class to watch for Bluetooth Advertisments.
+This sample shows how to create a BluetoothLEAdvertisementWatcher class to watch for Bluetooth Advertisements.
 
-Runs this sample and all the Bluetooth LE Advertisments will be listed.
+Runs this sample and all the Bluetooth LE Advertisements will be listed.
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/Central1/category.txt

@@ -0,0 +1 @@
+ble

samples/Bluetooth/Central2/README.md

@@ -1,12 +1,14 @@
-# 🌶️🌶️ - Bluetooth Low energy: Environmental Sensor data collection.
+# 🌶️🌶️ - Bluetooth Low energy: Environmental Sensor data collection
 
 Sample to collect temperature values from a collection of
-Environmental Sensor devices. 
+Environmental Sensor devices
 
-This sample will watch for Environmental sensors advertisements and connect to sensor reading temperture values.
+This sample will watch for Environmental sensors advertisements and connect to sensor reading temperature values.
 
 Shows how to watch for advertisements and connect to devices.
 
 Designed to work with the Bluetooth Sample 3.
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/Central2/category.txt

@@ -0,0 +1 @@
+ble

samples/Bluetooth/Central3/README.md

@@ -1,14 +1,14 @@
-# 🌶️🌶️🌶️ - Bluetooth Low energy: Demonstrates pairing and authentication in Client program.
+# 🌶️🌶️🌶️ - Bluetooth Low energy: Demonstrates pairing and authentication in Client program
 
-Sample to show how to Watch for advertisements and connect to a device which requires encryption and 
-authentication to access the Characteristics value.
+Sample to show how to Watch for advertisements and connect to a device which requires encryption and authentication to access the Characteristics value.
 
 This sample works with the BluetoothLESample2 sample as the server.
 
 Start the BluetoothLESample2 on another device and then run this sample.
 
 Pairing can be done before or ad hoc when the accessing the Characteristic.
-If Characteristic requires security or Authentication when accessed the system will automatically 
-start a pairing operation.
+If Characteristic requires security or Authentication when accessed the system will automatically start a pairing operation.
 
 See [main Bluetooth sample's readme](../README.md) for more information.
+
+The sample is [located here](./Program.cs).

samples/Bluetooth/Central3/category.txt

@@ -0,0 +1 @@
+ble

samples/Bluetooth/ImprovWifi/README.md

@@ -1,15 +1,17 @@
 # 🌶️🌶️🌶️ - Improv Wifi provisioning
 
-This sample shows the use of the *Improv class* to provision the Wifi credentials for an ESP32 device via Bluetooth LE.
+This sample shows the use of the `Improv` class to provision the Wifi credentials for an ESP32 device via Bluetooth LE.
 
-The device will advertise with the name "Improv sample" and support the *Improv Service* allowing the Wifi Credentials to be setup directly from the Improv test page.
-or any other web page.
+The device will advertise with the name `Improv sample` and support the `Improv Service` allowing the Wifi Credentials to be setup directly from the Improv test page or any other web page.
 
 This is an initial working version of the *Improv* class showing what can be done.
+
 Probably later this class can be moved to a separate repo, so it has its own nuGet package to make it easy to be consumed by applications.
 
-*Improv* is a free open standard which allows the device to be provisioned directly from a web page.
-This works for Chrome and Edge browsers.
+`Improv` is a free open standard which allows the device to be provisioned directly from a web page. This works for Chrome and Edge browsers.
+
+For more information on the `Improv` standard and a test page, see the [official Improv website](https://www.improv-wifi.com/).
+
+[See](https://www.improv-wifi.com/code/) for details on including it into other web pages.
 
-For more information on the *Improv* standard and a test page, see: <https://www.improv-wifi.com/>
-See <https://www.improv-wifi.com/code/> for details on including it into other web pages.
+The sample is [located here](./Program.cs).

samples/Bluetooth/ImprovWifi/category.txt

@@ -1,2 +1,3 @@
 esp32
 ble
+wifi