troubleshooting: add openweather service help (#471)

* troubleshooting: add openweather service help

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 33b8fb7b9d196fa8febb52895ba17a1545ccb166..8a0d11d99aacb76b84f83cddc97fb5dee4eda3dc 100644 (file)
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -47,3 +47,12 @@ To resolve this, you can either:
 This should be a configuration issue.
 * Make sure the option `connectivityCheck` is set to `true` in configuration.
 * Check your proxy configuration, the expected behavior is to redirect user using a 302 to the login page when user is not authenticated.
+
+## I put my API key into the OpenWeather service and it still isn't working
+
+If you have just made an OpenWeatherMap account and/or a newly-made API key, there is a high chance that you need to wait for it to be activated (often a few hours). If after waiting it still doesn't work, make sure to check the location you have provided since it may be an invalid location.
+
+For some basic debugging steps, you can: 
+* Check with a large city such as Amsterdam as the specified location within your configuration.
+* Make sure your web browser is running the latest version of the homer configuration after updating the location (Ctrl + Shift + R).
+* Check for errors within the browser console (Ctrl + Shift + I) relating to api.openweathermap.org