update READMEs

nfl-favorite-team/README.md

@@ -4,8 +4,6 @@ This folder contains data behind the story [The Rams Are Dead To Me, So I Answer
 
 `team-picking-categories.csv` contains grades for each NFL franchise in 16 categories, to be used to pick a new favorite team.
 
-Key for categories:
-
 | abbrev |                                                           category                                                            |
 |--------|-------------------------------------------------------------------------------------------------------------------------------|
 | FRL    | Fan relations - Courtesy by players, coaches and front offices toward fans, and how well a team uses technology to reach them |

pollster-ratings/readme.md

@@ -1,4 +1,4 @@
-## Pollster ratings
+# Pollster Ratings
 
 The data and calculations behind FiveThirtyEight's pollster ratings.
 

potential-candidates/README.md

@@ -1,20 +1,13 @@
-### Who Is Going To Run For President In 2016?
+# Potential 2016 Candidates
 
-Data behind our series of articles about who will run in the 2016 presidential primaries.
+This folder contains data behind the stories:
 
-## Articles
+* [Who Will Run For President: Romney Is Out](http://fivethirtyeight.com/datalab/romney-not-running-for-president)
+* [Looking For Clues: Who Is Going To Run For President In 2016?](http://fivethirtyeight.com/datalab/2016-president-who-is-going-to-run)
 
-Date | Headline | Folder
+`events.csv` contains events attended in Iowa and New Hampshire by potential presidential primary candidates.
----|---------|-------------
-Jan. 30, 2015 | [Who Will Run For President: Romney Is Out](http://fivethirtyeight.com/datalab/romney-not-running-for-president) | `potential-candidates/2015_01_30`
-Jan. 14, 2015 | [Looking For Clues: Who Is Going To Run For President In 2016?](http://fivethirtyeight.com/datalab/2016-president-who-is-going-to-run) | `potential-candidates/2015_01_14`
 
-
+`statements.csv` contains recent statements by potential presidential primary candidates scored using the following key:
-## Data
-
-* `events.csv` contains events attended in Iowa and New Hampshire by potential presidential primary candidates.
-
-* `statements.csv` contains recent statements by potential presidential primary candidates scored using the following key:
 
 	Score | Definition
 	---|---------
@@ -23,4 +16,3 @@ Jan. 14, 2015 | [Looking For Clues: Who Is Going To Run For President In 2016?](
 	3 | Unsure
 	4 | Actively exploring or seriously considering
 	5 | Definitely running
-

presidential-campaign-trail/README.md

@@ -1,6 +1,6 @@
-### Presidential campaign trail data
+# Presidential Campaign Trail
 
-The raw data behind the story [The Last 10 Weeks Of 2016 Campaign Stops In One Handy Gif](http://fivethirtyeight.com/features/the-last-10-weeks-of-2016-campaign-stops-in-one-handy-gif/)
+This folder contains data behind the story [The Last 10 Weeks Of 2016 Campaign Stops In One Handy Gif](http://fivethirtyeight.com/features/the-last-10-weeks-of-2016-campaign-stops-in-one-handy-gif/).
 
 Header | Definition
 ---|---------
@@ -9,6 +9,6 @@ Header | Definition
 `lat` | Latitude of the event location
 `lng` | Longitude of the event location
 
-Sources: 
+Sources:
 * [hillaryspeeches.com](https://hillaryspeeches.com/)
 * [conservativedailynews.com](http://www.conservativedailynews.com/)

presidential-commencement-speeches/README.md

@@ -1,6 +1,8 @@
-### Presidential commencement speeches
+# Presidential Commencement Speeches
 
-The data behind the story [Sitting Presidents Give Way More Commencement Speeches Than They Used To](http://fivethirtyeight.com/features/sitting-presidents-give-way-more-commencement-speeches-than-they-used-to/), not including commencement speeches by President Obama in 2016
+This folder contains data behind the story [Sitting Presidents Give Way More Commencement Speeches Than They Used To](http://fivethirtyeight.com/features/sitting-presidents-give-way-more-commencement-speeches-than-they-used-to/)
+
+Data does not include commencement speeches by President Obama in 2016.
 
 Header | Definition
 ---|---------

puerto-rico-media/README.md

@@ -23,5 +23,3 @@ TV News Data was collected from the [Internet TV News Archive](https://archive.o
 Google search data was collected using the [Google Trends](https://trends.google.com/trends/) dashboard.
 
 * `google_trends.csv` - Contains data on google trend searches for Hurricanes Harvey, Irma, Jose, and Maria.
-
-

pulitzer/README.md

@@ -0,0 +1,3 @@
+# Pulitzer
+
+This folder contains data behind the story [Do Pulitzers Help Newspapers Keep Readers?](https://fivethirtyeight.com/features/do-pulitzers-help-newspapers-keep-readers/).

region-survey/README.md

@@ -1,7 +1,9 @@
+# Region Survey
+
+This folder contains data behind the stories:
+
+* [Which States Are in the South?](http://fivethirtyeight.com/datalab/which-states-are-in-the-south/)
+* [Which States Are in the Midwest?](http://fivethirtyeight.com/datalab/what-states-are-in-the-midwest/)
+* [We’ve Published Our Data on the South And Midwest](http://fivethirtyeight.com/datalab/weve-published-our-data-on-the-south-and-midwest/)
+
 `SOUTH.csv` and `MIDWEST.csv` contain individual responses from surveys about regional identification conducted for FiveThirtyEight by SurveyMonkey.
-
-See also: 
-
- * http://fivethirtyeight.com/datalab/which-states-are-in-the-south/
- * http://fivethirtyeight.com/datalab/what-states-are-in-the-midwest/
- * http://fivethirtyeight.com/datalab/weve-published-our-data-on-the-south-and-midwest/

religion-survey/README.md

@@ -1,5 +1,5 @@
-### Religion Survey
+# Religion Survey
 
-This directory contains the data behind the story [When Does Praying In Public Make Others Uncomfortable?](http://fivethirtyeight.com/features/when-does-praying-in-public-make-others-uncomfortable)
+This directory contains the data behind the story [When Does Praying In Public Make Others Uncomfortable?](http://fivethirtyeight.com/features/when-does-praying-in-public-make-others-uncomfortable).
 
 Using a SurveyMonkey poll, conducted between July 29 and August 1, 2016, we asked 661 respondents [questions about public displays of religion](https://espnfivethirtyeight.files.wordpress.com/2016/09/surveymonkey_82631483.pdf).

reluctant-trump/README.md

@@ -1,11 +1,10 @@
-# SurveyMonkey Survey of Reluctant Trump Voters
+# Reluctant Trump Voters
 
 This directory contains the raw data behind the stories:
 
-- [Trump’s Reluctant Voters Are Getting More Reluctant](https://fivethirtyeight.com/features/trumps-reluctant-voters-are-getting-more-reluctant/)
+* [Trump’s Reluctant Voters Are Getting More Reluctant](https://fivethirtyeight.com/features/trumps-reluctant-voters-are-getting-more-reluctant/)
-- [How Trump’s Least Enthusiastic Voters Feel About Him Now](https://fivethirtyeight.com/features/how-trumps-least-enthusiastic-voters-feel-about-him-now/)
+* [How Trump’s Least Enthusiastic Voters Feel About Him Now](https://fivethirtyeight.com/features/how-trumps-least-enthusiastic-voters-feel-about-him-now/)
-- [‘Reluctant’ Trump Voters Swung The Election. Here’s How They Think He’s Doing](https://fivethirtyeight.com/features/reluctant-trump-voters-swung-the-election-heres-how-they-think-hes-doing/)
+* [‘Reluctant’ Trump Voters Swung The Election. Here’s How They Think He’s Doing](https://fivethirtyeight.com/features/reluctant-trump-voters-swung-the-election-heres-how-they-think-hes-doing/)
-
 
 Files in this directory contain data from a SurveyMonkey News Survey conducted in partnership with FiveThirtyEight and include crosstabs of Trump voters who were excited to vote for Trump versus those who were not.
 

repeated-phrases-gop/README.md

@@ -1,6 +1,6 @@
-### The phrases most repeated by GOP candidates
+# Repeated Phrases GOP
 
-The raw data behind the story [These Are The Phrases Each GOP Candidate Repeats Most](http://fivethirtyeight.com/features/these-are-the-phrases-each-gop-candidate-repeats-most)
+This folder contains data behind the story [These Are The Phrases Each GOP Candidate Repeats Most](http://fivethirtyeight.com/features/these-are-the-phrases-each-gop-candidate-repeats-most).
 
 File | Description
 ---|---------

san-andreas/README.md

@@ -1,7 +1,8 @@
 ### Earthquake data
 
-This directory contains the data behind the story [The Rock Isn’t Alone: Lots Of People Are Worried About ‘The Big One’](http://fivethirtyeight.com/datalab/the-rock-isnt-alone-lots-of-people-are-worried-about-the-big-one). The data file `earthquake_data.csv` contains the following variables:
+This directory contains the data behind the story [The Rock Isn’t Alone: Lots Of People Are Worried About ‘The Big One’](http://fivethirtyeight.com/datalab/the-rock-isnt-alone-lots-of-people-are-worried-about-the-big-one).
-	
+
+`earthquake_data.csv` contains the following variables:
 
 Header | Definition
 ---|---------

sandy-311-calls/Readme.md

@@ -1,6 +1,6 @@
 # Sandy 311 Calls
 
-Raw data behind the story [The (Very) Long Tail Of Hurricane Recovery](https://projects.fivethirtyeight.com/sandy-311/).
+This folder contains data behind the story [The (Very) Long Tail Of Hurricane Recovery](https://projects.fivethirtyeight.com/sandy-311/).
 
 Data was collected from the [NYC OpenData](https://data.cityofnewyork.us/City-Government/311-Call-Center-Inquiry/tdd6-3ysr) website. The [data dictionary](https://data.cityofnewyork.us/api/views/wewp-mm3p/files/3a563b1d-9e0b-4824-98c7-a308bbc5ce6e?download=true&filename=Call%20Center%20Inquiry%20Data%20Dictionary.xlsx), hosted on the city's  website, contains an "Agency List" tab with the full form of each agency's acronym.
 

science-giving/README.md

@@ -1,6 +1,6 @@
-### Political Donations From the Scientific Community
+# Science Giving
 
-This directory contains the raw data behind [When Scientists Donate To Politicians, It’s Usually To Democrats](https://fivethirtyeight.com/features/when-scientists-donate-to-politicians-its-usually-to-democrats).
+This directory contains the data behind the story [When Scientists Donate To Politicians, It’s Usually To Democrats](https://fivethirtyeight.com/features/when-scientists-donate-to-politicians-its-usually-to-democrats).
 
 The data in `science_federal_giving.csv` is from the Federal Election Commission, filtered to donations form the following occupations from 2007 to 2016: 
 * computer and information scientists

scrabble-games/README.md

@@ -1,6 +1,6 @@
-### Scrabble tournament games data
+# Scrabble Games
 
-The raw data behind the story [How 'Qi' And 'Za' Changed Scrabble](https://fivethirtyeight.com/features/how-qi-and-za-changed-scrabble/)
+This folder contains data behind the story [How 'Qi' And 'Za' Changed Scrabble](https://fivethirtyeight.com/features/how-qi-and-za-changed-scrabble/).
 
 Header | Definition
 ---|---------

sleeping-alone-data/README.md

@@ -0,0 +1,3 @@
+# Sleeping Alone
+
+This folder contains data behind the story [Dear Mona, How Many Couples Sleep in Separate Beds?](https://fivethirtyeight.com/features/dear-mona-how-many-couples-sleep-in-separate-beds/).

soccer-spi/README.md

@@ -5,7 +5,8 @@ files:
 ---
 # SPI Ratings
 
-This contains the raw data behind our [Club Soccer Predictions](https://projects.fivethirtyeight.com/soccer-predictions/) and [Global Club Soccer Rankings](https://projects.fivethirtyeight.com/global-club-soccer-rankings/).
+This readme contains links to the data behind our [Club Soccer Predictions](https://projects.fivethirtyeight.com/soccer-predictions/) and [Global Club Soccer Rankings](https://projects.fivethirtyeight.com/global-club-soccer-rankings/). For the latest version of this updating data set, visit the links at the top of this README.
 
-* `spi_matches.csv` - Match-by-match SPI ratings and forecasts back to 2016.
+`spi_matches.csv` contains match-by-match SPI ratings and forecasts back to 2016.
-* `spi_global_rankings.csv` - Current SPI ratings and rankings for men's club teams.
+
+`spi_global_rankings.csv` contains current SPI ratings and rankings for men's club teams.

star-wars-survey/README.md

@@ -0,0 +1,3 @@
+# Star Wars Survey
+
+This folder contains data behind the story [America’s Favorite ‘Star Wars’ Movies (And Least Favorite Characters)](https://fivethirtyeight.com/features/americas-favorite-star-wars-movies-and-least-favorite-characters/).

steak-survey/README.md

@@ -0,0 +1,6 @@
+# Steak Survey
+
+This folder contains data behind the stories:
+* [How Americans Like Their Steak](https://fivethirtyeight.com/features/how-americans-like-their-steak/).
+* [How Americans Order Their Steak](https://fivethirtyeight.com/features/how-americans-order-their-steak/)
+