Rewrite public API documentation

examples/requests.http

@@ -0,0 +1,45 @@
+@baseUrl = http://localhost:8080
+
+### Latest observation
+GET {{baseUrl}}/observations?units=metric&precision=1
+Accept: application/json
+
+### Current conditions
+GET {{baseUrl}}/conditions/current?units=us&precision=0
+Accept: application/json
+
+### Active alerts as text
+GET {{baseUrl}}/alerts/active?format=text
+
+### Hourly forecast in US units
+GET {{baseUrl}}/forecast/hourly?units=us&precision=1&tz=Chicago
+Accept: application/json
+
+### Hourly forecast for today
+GET {{baseUrl}}/forecast/hourly/today?tz=CDT
+Accept: application/json
+
+### Narrative forecast for tomorrow as text
+GET {{baseUrl}}/forecast/narrative/tomorrow?format=text&tz=America/Chicago
+
+### Full forecast discussion
+GET {{baseUrl}}/discussion?tz=CDT
+Accept: application/json
+
+### Forecast discussion key messages as text
+GET {{baseUrl}}/discussion/key-messages?format=text
+
+### Forecast discussion short term
+GET {{baseUrl}}/discussion/short-term?tz=CDT
+Accept: application/json
+
+### Forecast discussion long term
+GET {{baseUrl}}/discussion/long-term?TZ=-5
+Accept: application/json
+
+### Weather stories
+GET {{baseUrl}}/weatherstories?tz=America/Chicago
+Accept: application/json
+
+### Latest weather story as XML
+GET {{baseUrl}}/weatherstories/latest?format=xml