Fixed typos & punctuation, added hyperlinks

README.md

@@ -1,10 +1,12 @@
 # DIA-toolkit
-This repository contains all the program codes developed in the "Distributional Impact Analysis: Toolkit and Illustrations of Impacts Beyond the Average Treatment Effect" by Guadalupe Bedoya (World Bank), Luca Bittarello (Northwestern University), Jonathan Davis (University of Chicago), and Nikolas Mittag (CERGE-EI) available at [the World Bank Policy Research Working Paper Series]( http://documents.worldbank.org/curated/en/292901499351272899/pdf/WPS8139.pdf)
+
+This repository contains all the program codes developed in the "Distributional Impact Analysis: Toolkit and Illustrations of Impacts Beyond the Average Treatment Effect", by Guadalupe Bedoya (World Bank), Luca Bittarello (Northwestern University), Jonathan Davis (University of Chicago) and Nikolas Mittag (CERGE-EI), available at [the World Bank Policy Research Working Paper Series]( http://documents.worldbank.org/curated/en/292901499351272899/pdf/WPS8139.pdf)
 
 
 ## How to Use the DIA-Toolkit
 
-To replicate the simulations in the toolkit and the analysis in Part 7, start on `/estimation/master.do`. This master file sets global paths, sets the current directory  and loads auxiliary programs.
+To replicate the simulations in the toolkit and the analysis in Part 7, start on `/estimation/master.do`.
+This master file sets global paths, sets the current directory and loads auxiliary programs.
 
 ### Replicating Simulations throughout Toolkit
 
@@ -27,31 +29,31 @@ These files involve bootstrapping, which may be lengthy. The folder `/results/bo
 
 Three files are avaiilable under `/estimation/gambia/`:
 
-- `gambia_setup.do` sets up the data (which was provided by M. Blimpo, D.K. Evans and N. Lahire (2015): WB Policy Research WP 7238).
-- `gambia_analysis.do` replicates all of Section 7.2
-- `gambia_simulations.do` replicates the deconvolution estimates using simulated data designed to mimic our sample from The Gambia. (This file is called by `/estimation/simulations/simulations.do`.
+- `gambia_setup.do` sets up the data (provided by M. Blimpo, D.K. Evans and N. Lahire (2015): [WB Policy Research WP 7238](https://elibrary.worldbank.org/doi/abs/10.1596/1813-9450-7238)).
+- `gambia_analysis.do` replicates all of Section 7.2.
+- `gambia_simulations.do` replicates the deconvolution estimates using simulated data designed to mimic our sample from The Gambia. (This file is called by `/estimation/simulations/simulations.do`.)
 
 ### Programs
 
-These programs are available in `/programs/`.
+These programs are available under `/programs/`:
 
 - `dte.do` computes changes the distribution of marginal outcomes and its features. `dte.sthlp` documents the syntax (from Stata, run `help dte`).
 - `bscr.do` computes simultaneous confidence regions and critical values from a bootstrap sample of estimators according to Romano and Wolf (2010). `bscr.sthlp` documents the syntax (from Stata, run `help bscr`).
 
-## How to Contribute 
-If you are familiar with GitHub pelase feel free to fork the repository and submit a *pull request* with your suggested edits.
+## How to Contribute
 
-An easy but still very efficient way to provide any feedback on the code in this repository is to create an *issue* in GitHub. You can read *issues* submitted by other users or create a new *issue* in the top menu below [**worldbank**/**DIA-toolkit**](https://github.com/worldbank/DIA-toolkit) at [https://github.com/worldbank/DIA-toolkit](https://github.com/worldbank/DIA-toolkit). While the word *issue* has a negative connotation outside GitHub, it can be used for any kind of feedback. If you have identified a bug or an enhancement please create a new *issue* to let us know. Your feedback is very important to us. Please read already existing *issues* to check whether someone else has made the same suggestion or reported the same error before creating a new *issue*.
+If you are familiar with GitHub, please feel free to fork the repository and submit a *pull request* with your suggested edits.
 
-## License
+An easy but still very efficient way to provide any feedback on the code in this repository is to create an *issue* in GitHub. You can read *issues* submitted by other users or create a new *issue* in the top menu below [**worldbank**/**DIA-toolkit**](https://github.com/worldbank/DIA-toolkit) at [https://github.com/worldbank/DIA-toolkit](https://github.com/worldbank/DIA-toolkit). While the word *issue* has a negative connotation outside GitHub, it can be used for any kind of feedback. If you have identified a bug or enhancement, please create a new *issue* to let us know. Your feedback is very important to us. Please read existing *issues* to check whether someone else has made the same suggestion or reported the same error before creating a new *issue*.
 
-This software is released under the Creative Commons Attribution 4.0 International license. You can view a license summary here:
-https://creativecommons.org/licenses/by/4.0/
+## License
 
+This software is released under the Creative Commons Attribution 4.0 International license.
+You can view a license summary [here](https://creativecommons.org/licenses/by/4.0/).
 
 ## How to Reference the DIA-Toolkit
 
-Use the following reference for attribution:
+Suggested citation:
 
 Bedoya, Guadalupe, Luca Bittarello, Jonathan Davis, and Nikolas Mittag. "Distributional Impact Analysis: Toolkit and Illustrations of Impacts Beyond the Average Treatment Effect." [World Bank Policy Research Working Paper Series]( http://documents.worldbank.org/curated/en/292901499351272899/pdf/WPS8139.pdf), No. WPS 8139. Washington, D.C. (July 2017)