diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..e9dd352
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,58 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: 'type: bug'
+assignees: ''
+
+---
+
+<!--
+
+   ************************************** WARNING **************************************
+
+   The ciarcom bot parses this header automatically. Any deviation from the 
+   template may cause the bot to automatically correct this header or may result in a 
+   warning message, requesting updates.
+
+   PLEASE ENSURE ALL SECTIONS OF THIS TEMPLATE ARE FILLED IN AND THAT THERE ARE
+   NO OTHER CHANGES TO THE TEMPLATE.    
+   
+   Only bugs should be raised here as issues. Questions or enhancements should instead be raised on 
+   our forums:
+   https://forums.mbed.com/ .
+
+   *************************************************************************************
+
+-->
+
+### Description of defect
+
+<!--
+    Add detailed description of what you are reporting.
+    Good example: https://os.mbed.com/docs/mbed-os/latest/contributing/workflow.html
+-->
+
+
+#### Target(s) affected by this defect ?
+
+
+#### Toolchain(s) (name and version) displaying this defect ?
+
+
+#### What version of Mbed-os are you using (tag or sha) ?
+<!--
+    For a released version please provide the release tag (this can be found as per the instructions below)
+
+    mbed-os version can be found in:
+    https://github.com/ARMmbed/mbed-os/blob/master/platform/include/platform/mbed_version.h
+    The tag can be reconstructed as follows:
+    mbed-os-MBED_MAJOR_VERSION.MBED_MINOR_VERSION.MBED_PATCH_VERSION
+     
+-->
+
+
+#### What version(s) of tools are you using. List all that apply (E.g. mbed-cli)
+
+
+#### How is this defect reproduced ?
diff --git a/README.md b/README.md
index 2771ddd..6b57fda 100644
--- a/README.md
+++ b/README.md
@@ -11,10 +11,37 @@ It has been tested on K64F with Ethernet and DISCO_L475VG_IOT01A with WiFi, but
 
 ## Setting up an Azure IoT Hub account
 
-Follow Azure IoT Hub's official documentation to
-
-1. Create a new hub on the Azure portal ([documentation](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-create-through-portal#create-an-iot-hub)). You will need a [_Standard_ tier](https://azure.microsoft.com/en-gb/pricing/details/iot-hub/) hub to enable cloud-to-device messages for this example, and a free option is available in this tier.
-1. Register a new device to the hub you have created ([documentation](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-create-through-portal#register-a-new-device-in-the-iot-hub)). Make a copy of the "Primary Connection String" of the device.
+<!--Follow Azure IoT Hub's official documentation to -->
+
+<!--1. Create a new hub on the Azure portal ([documentation](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-create-through-portal#create-an-iot-hub)). You will need a [_Standard_ tier](https://azure.microsoft.com/en-gb/pricing/details/iot-hub/) hub to enable cloud-to-device messages for this example, and a free option is available in this tier.
+1. Register a new device to the hub you have created ([documentation](https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-create-through-portal#register-a-new-device-in-the-iot-hub)). Make a copy of the "Primary Connection String" of the device.-->
+1. Create an [Azure account](https://azure.microsoft.com/en-gb/free/)
+1. Log in to your Azure account and you should see the console below. Click on "Create a resource"
+![step1](./resources/Step1.jpg)
+1. Click on "IoT Hub" by searching in the bar as shown below
+![step2](./resources/Step2.jpg)
+1. Click on "Create"
+![step3](./resources/Step3.jpg)
+1. Fill in the details ensuring the subscription is set to "Free Trial". Choose a resource group, region, and hub name of your choosing
+![step4](./resources/Step4.jpg)
+1. Ensure "Public endpoint (all networks)" is selected then click on "Next: Size and scale"
+![step5](./resources/Step5.jpg)
+1. Ensure price is set to "Free tier"
+![step6](./resources/Step6.jpg)
+1. Add a description of your device as shown below then click "Next: Review and create"
+![step7](./resources/Step7.jpg)
+1. Click "Create"
+![step8](./resources/Step8.jpg)
+1. Click "Add and configure IoT Devices"
+![step9](./resources/Step9.jpg)
+1. Click "New"
+![step10](./resources/Step10.jpg)
+1. Give an ID name to your device then click "Save"
+![step11](./resources/Step11.jpg)
+1. Click on the device you have just created 
+![step12](./resources/Step12.jpg)
+1. Copy the Primary Connection String
+![step13](./resources/Step13.jpg)
 
 Now the IoT Hub is ready for use in this example.
 
diff --git a/resources/Step1.jpg b/resources/Step1.jpg
new file mode 100644
index 0000000..55efc3c
Binary files /dev/null and b/resources/Step1.jpg differ
diff --git a/resources/Step10.jpg b/resources/Step10.jpg
new file mode 100644
index 0000000..fcc031b
Binary files /dev/null and b/resources/Step10.jpg differ
diff --git a/resources/Step11.jpg b/resources/Step11.jpg
new file mode 100644
index 0000000..3ddf8a1
Binary files /dev/null and b/resources/Step11.jpg differ
diff --git a/resources/Step12.jpg b/resources/Step12.jpg
new file mode 100644
index 0000000..dce7368
Binary files /dev/null and b/resources/Step12.jpg differ
diff --git a/resources/Step13.jpg b/resources/Step13.jpg
new file mode 100644
index 0000000..6c1d38c
Binary files /dev/null and b/resources/Step13.jpg differ
diff --git a/resources/Step2.jpg b/resources/Step2.jpg
new file mode 100644
index 0000000..03268f1
Binary files /dev/null and b/resources/Step2.jpg differ
diff --git a/resources/Step3.jpg b/resources/Step3.jpg
new file mode 100644
index 0000000..e591172
Binary files /dev/null and b/resources/Step3.jpg differ
diff --git a/resources/Step4.jpg b/resources/Step4.jpg
new file mode 100644
index 0000000..81ce100
Binary files /dev/null and b/resources/Step4.jpg differ
diff --git a/resources/Step5.jpg b/resources/Step5.jpg
new file mode 100644
index 0000000..598265b
Binary files /dev/null and b/resources/Step5.jpg differ
diff --git a/resources/Step6.jpg b/resources/Step6.jpg
new file mode 100644
index 0000000..1a584f4
Binary files /dev/null and b/resources/Step6.jpg differ
diff --git a/resources/Step7.jpg b/resources/Step7.jpg
new file mode 100644
index 0000000..846df33
Binary files /dev/null and b/resources/Step7.jpg differ
diff --git a/resources/Step8.jpg b/resources/Step8.jpg
new file mode 100644
index 0000000..8118f27
Binary files /dev/null and b/resources/Step8.jpg differ
diff --git a/resources/Step9.jpg b/resources/Step9.jpg
new file mode 100644
index 0000000..3f3cb97
Binary files /dev/null and b/resources/Step9.jpg differ