diff --git a/us-weather-history/README.md b/us-weather-history/README.md
new file mode 100644
index 0000000..e5d79df
--- /dev/null
+++ b/us-weather-history/README.md
@@ -0,0 +1,31 @@
+### U.S. weather history visualization
+
+The raw data and code behind the story [FILL THIS IN](http://www.fivethirtyeight.com/)
+
+#### Code
+
+Code file | Description
+---|---------
+`wunderground_scraper.py` | Downloades weather data web pages from Weather Underground
+`wunderground_parser.py` | Parses the weather data from Weather Underground into a flat CSV file
+`visualize_weather.py` | Creates the visualization of the weather data
+
+#### Data
+
+Column | Description
+---|---------
+`date` | The date of the weather record, formatted YYYY-M-D
+`actual_mean_temp` | The measured average temperature for that day
+`actual_min_temp` | The measured minimum temperature for that day
+`actual_max_temp` | The measured maximum temperature for that day
+`average_min_temp` | The average minimum temperature on that day since 1880
+`average_max_temp` | The average maximum temperature on that day since 1880
+`record_min_temp` | The lowest ever temperature on that day since 1880
+`record_max_temp` | The highest ever temperature on that day since 1880
+`record_min_temp_year` | The year that the lowest ever temperature occurred
+`record_max_temp_year` | The year that the highest ever temperature occurred
+`actual_precipitation` | The measured amount of rain or snow for that day
+`average_precipitation` | The average amount of rain or snow on that day since 1880
+`record_precipitation` | The highest amount of rain or snow on that day since 1880
+
+Source: [Weather Underground](http://wunderground.com)