updated readme with FAQ / troubleshooting section

README.md

@@ -15,11 +15,24 @@ The quickstart webapp is meant to be paired with the [quickstart embedded app](h
     ```
     or set an evironment variable called `ACCESS_KEY` with the value of your API key
 2. Run the `app.py` file
-    ```python
-    python ./app.py
-    ```
+```python
+python ./app.py
+```
 3. Open a web page to the web.py server. Usually [//localhost:8080](//localhost:8080) will work. 
 4. Interact with the web page, blink the LED's, subscribe to the resources, click the button on the board and see the numbers tick up on the web app.
     {{TODO: insert gif's here}}
 5. Modify : go checkout the API for the [mbed-connector-api-python library](https://docs.mbed.com/docs/mbed-connector-api-python/en/latest/) and make your own applications!
 
+
+## Troubleshooting
+Here are some common problems and their solutions.
+
+##### Cannot establish a secure connection
+This is most likely caused by not having the `requests[security]` package installed. If you are using Ubuntu 14.4 LTS you may need to update pip first `pip install -U pip` and then install the requests security package `pip install -U requests[security]`. 
+
+##### WebSocket transport not available
+Dont worry about that warning message, it is not applicable to this demo, but likewise the warning message cannot be disabled. 
+
+##### ERROR 500 on trying to run the app.py file
+Make sure you added your [Access Key](https://connector.mbed.com/#accesskeys) to the app. You can do this by either changing the value of the `token` variable in the app.py file or by setting the `ACCESS_KEY` environment variable to your access key. 
+