update READMEs

kovalyovi · Feb 9, 2018 · 40258f5 · 40258f5
1 parent 831e5fe
commit 40258f5
Show file tree

Hide file tree

Showing 10 changed files with 27 additions and 34 deletions.
diff --git a/nfl-suspensions/README.md b/nfl-suspensions/README.md
@@ -1,6 +1,6 @@
-### NFL suspensions data
+# NFL Suspensions
 
-The raw data behind the story, [The NFL’s Uneven History Of Punishing Domestic Violence](http://fivethirtyeight.com/features/nfl-domestic-violence-policy-suspensions/).
+This folder contains data behind the story [The NFL’s Uneven History Of Punishing Domestic Violence](http://fivethirtyeight.com/features/nfl-domestic-violence-policy-suspensions/).
 
 Header | Definition
 ---|---------

diff --git a/nfl-ticket-prices/README.md b/nfl-ticket-prices/README.md
@@ -1,8 +1,6 @@
-### NFL Ticket Prices
+# NFL Ticket Prices
 
-This directory contains the data behind the story:
-
-[Who Goes To Meaningless NFL Games And Why?](http://fivethirtyeight.com/datalab/who-goes-to-meaningless-nfl-games-and-why/)
+This directory contains the data behind the story [Who Goes To Meaningless NFL Games And Why?](http://fivethirtyeight.com/datalab/who-goes-to-meaningless-nfl-games-and-why/).
 
 There are three data files:
 

diff --git a/nfl-wide-receivers/README.md b/nfl-wide-receivers/README.md
@@ -1,4 +1,8 @@
-Advanced career stats for NFL receivers, 1932-2013.
+# NFL Wide Receivers
+
+This folder contains data behind the story [The Football Hall Of Fame Has A Receiver Problem](http://fivethirtyeight.com/features/the-football-hall-of-fame-has-a-receiver-problem/).
+
+`advanced-historical.csv` contains advanced career stats for NFL receivers, 1932-2013.
 
 Header | Definition
 ---|---------
@@ -9,9 +13,7 @@ Header | Definition
 `career_wowy` | The amount by which career_ranypa exceeds what would be expected from his QBs' (age-adjusted) performance without the receiver
 `bcs_rating` | The number of yards per game by which a player would outgain an average receiver on the same team, after adjusting for teammate quality and age (update of http://www.sabernomics.com/sabernomics/index.php/2005/02/ranking-the-all-time-great-wide-receivers/)
 
-http://fivethirtyeight.com/features/the-football-hall-of-fame-has-a-receiver-problem/
-
-Receiver aging curve definitions:
+`try-per-game-aging-curve.csv` contains receiver aging curve definitions.
 
 Header | Definition
 ---|---------

diff --git a/nutrition-studies/README.md b/nutrition-studies/README.md
@@ -1,4 +1,4 @@
-### Nutrition Studies
+# Nutrition Studies
 
 This directory contains data and code behind the story [You Can’t Trust What You Read About Nutrition](http://fivethirtyeight.com/features/you-cant-trust-what-you-read-about-nutrition).
 

diff --git a/obama-commutations/README.md b/obama-commutations/README.md
@@ -1,6 +1,6 @@
-### Obama commutation data
+# Obama Commutation
 
-The raw data behind the story [Obama Granted Clemency Unlike Any Other President In History](https://fivethirtyeight.com/features/obama-granted-clemency-unlike-any-other-president-in-history/)
+This folder contains data behind the story [Obama Granted Clemency Unlike Any Other President In History](https://fivethirtyeight.com/features/obama-granted-clemency-unlike-any-other-president-in-history/).
 
 The data in `obama_commutations.csv` is copied from the Justice Department website. The python script parses it by looking at the first column to figure out what is contained in the second column.
 

diff --git a/pew-religions/README.md b/pew-religions/README.md
@@ -1,6 +1,5 @@
-### Pew Religions Model
+# Pew Religions Model
 
 This directory contains the code and data behind the story [Evangelical Protestants Are The Biggest Winners When People Change Faiths](http://fivethirtyeight.com/datalab/evangelical-protestants-are-the-biggest-winners-when-people-change-faiths/).
 
 The model uses the [Pew Research Center's 2014 Religious Landscape Survey](http://www.pewforum.org/2015/05/12/americas-changing-religious-landscape/) to measure the relative "pull" of different American religious groups by using Pew's transition matrix for rates of conversions between various faiths to compute what the eventual, stable proportions of religious faiths would be, if people kept leaving and joining faiths at the current rates until the overall numbers stabilized.
-
diff --git a/police-deaths/README.md b/police-deaths/README.md
@@ -1,4 +1,4 @@
-### Police Deaths
+# Police Deaths
 
 This directory contains the data and code behind the story [The Dallas Shooting Was Among The Deadliest For Police In U.S. History](https://fivethirtyeight.com/features/the-dallas-shooting-was-among-the-deadliest-for-police-in-u-s-history/). The primary source of data is the [Officer Down Memorial Page](https://www.odmp.org/) (ODMP), started in 1996 by a college student who is now a police officer and who continues to maintain the database.
 

diff --git a/police-killings/README.md b/police-killings/README.md
@@ -1,4 +1,4 @@
-### Police Killings
+# Police Killings
 
 This directory contains the data behind the story [Where Police Have Killed Americans In 2015](http://fivethirtyeight.com/features/where-police-have-killed-americans-in-2015).
 

diff --git a/police-locals/README.md b/police-locals/README.md
@@ -1,6 +1,6 @@
-### Police residence data
+# Police Residence
 
-The raw data behind the story, [Most Police Don’t Live In The Cities They Serve](http://fivethirtyeight.com/datalab/most-police-dont-live-in-the-cities-they-serve/)
+This folder contains data behind the story [Most Police Don’t Live In The Cities They Serve](http://fivethirtyeight.com/datalab/most-police-dont-live-in-the-cities-they-serve/).
 
 Includes the cities with the 75 largest police forces, with the exception of Honolulu for which data is not available. All calculations are based on data from the U.S. Census.
 

diff --git a/poll-of-pollsters/README.md b/poll-of-pollsters/README.md
@@ -1,20 +1,14 @@
-### Poll of Pollsters data
+# Poll of Pollsters
 
-This repo contains the responses from pollsters to FiveThirtyEight's seven polls of professional political pollsters, as described in these articles:
+This folder contains the responses from pollsters to FiveThirtyEight's seven polls of professional political pollsters, as described in these articles:
 
-[Pollsters Predict Greater Polling Error In Midterm Elections](http://fivethirtyeight.com/features/pollsters-predict-greater-polling-error-in-midterm-elections/)
-
-[Pollsters Say They Follow Ethical Standards, But They Aren’t So Sure About Their Peers](http://fivethirtyeight.com/features/pollsters-say-they-follow-ethical-standards-but-they-arent-so-sure-about-their-peers)
-
-[Even Pollsters Don’t Know All The Details Of How Their Polls Are Made](http://fivethirtyeight.com/features/even-pollsters-dont-know-all-the-details-of-how-their-polls-are-made/)
-
-[Most Pollsters We Surveyed Say Polling Did Well This Year](http://fivethirtyeight.com/features/most-pollsters-we-surveyed-say-polling-did-well-this-year/)
-
-[Most Pollsters Say Their Reputations Have Worsened](http://fivethirtyeight.com/features/most-pollsters-say-their-reputations-have-worsened/)
-
-[Iowa Teaches Pollsters To Poll Until The End](http://fivethirtyeight.com/features/iowa-teaches-pollsters-to-poll-until-the-end/)
-
-[Top Pollsters Expect Clinton To Win](http://fivethirtyeight.com/features/top-pollsters-expect-clinton-to-win/)
+* [Pollsters Predict Greater Polling Error In Midterm Elections](http://fivethirtyeight.com/features/pollsters-predict-greater-polling-error-in-midterm-elections/)
+* [Pollsters Say They Follow Ethical Standards, But They Aren’t So Sure About Their Peers](http://fivethirtyeight.com/features/pollsters-say-they-follow-ethical-standards-but-they-arent-so-sure-about-their-peers)
+* [Even Pollsters Don’t Know All The Details Of How Their Polls Are Made](http://fivethirtyeight.com/features/even-pollsters-dont-know-all-the-details-of-how-their-polls-are-made/)
+* [Most Pollsters We Surveyed Say Polling Did Well This Year](http://fivethirtyeight.com/features/most-pollsters-we-surveyed-say-polling-did-well-this-year/)
+* [Most Pollsters Say Their Reputations Have Worsened](http://fivethirtyeight.com/features/most-pollsters-say-their-reputations-have-worsened/)
+* [Iowa Teaches Pollsters To Poll Until The End](http://fivethirtyeight.com/features/iowa-teaches-pollsters-to-poll-until-the-end/)
+* [Top Pollsters Expect Clinton To Win](http://fivethirtyeight.com/features/top-pollsters-expect-clinton-to-win/)
 
 We sent out the first poll starting Wed. Sept. 24, 2014, and 26 pollsters responded by deadline. We sent out the second poll starting Sunday, Oct. 12, and 24 pollsters responded by deadline. We sent out the third poll starting Friday, Oct. 24, and 26 pollsters responded by deadline. We sent out the fourth poll starting Wednesday, Nov. 5, and 17 pollsters responded by deadline. We sent out the fifth poll starting Friday, Dec. 11, 2015, and 26 pollsters responded by deadline. We sent out the sixth poll starting Tuesday, Feb. 2, 2016, and eight pollsters responded by deadline. We sent out the seventh poll starting Saturday, Oct. 8, 2016, and 33 pollsters responded by deadline.