diff --git a/README.md b/README.md
index bc7f1e0..4cf2de0 100644
--- a/README.md
+++ b/README.md
@@ -1,40 +1,39 @@
# Statistical Laws in Complex Systems
-This repository contains the data and code used in the anlaysis of the results presented in the manuscript "Statistical Laws in Complex Systems", [arXiv:2407.19874](https://arxiv.org/abs/2407.19874) (2024).
+This repository contains the data and code used in the manuscript "Statistical Laws in Complex Systems", [arXiv:2407.19874](https://arxiv.org/abs/2407.19874) (2024).
-## Folder Division:
+## Folders:
-data/
-datasets used in the analysis; Data on language needs to be downloaded from https://doi.org/10.5281/zenodo.13119897
+- data/
+ datasets used in the analysis. The data on linguistic laws is large and needs to be downloaded from https://doi.org/10.5281/zenodo.13119897
-notebooks/
-Notebooks used to generate the figures of the paper
-
-src/
-source code used in the data analysis
+- notebooks/
+jupyter notebooks used to generate the figures of the paper.
+- src/
+source code used in the data analysis.
## Credit:
-This repository builds on the ideas, code, and data provided in previous work:
+This repository builds on the ideas, code, and data from:
- Urban Scaling laws:
-Paper: J. C. Leitao, J.M. Miotto, M. Gerlach, and E. G. Altmann, "Is this scaling nonlinear?", Royal Society Open Science 3, 150649 (2016)
-Paper: E. G. Altmann, "Spatial interactions in urban scaling laws", PLOS ONE 15, e0243390 (2020)
-Code: https://github.com/edugalt/scaling
+ - Paper: J. C. Leitao, J.M. Miotto, M. Gerlach, and E. G. Altmann, "Is this scaling nonlinear?", [Royal Society Open Science 3, 150649 (2016)](http://rsos.royalsocietypublishing.org/content/3/7/150649)
+ - Paper: E. G. Altmann, "Spatial interactions in urban scaling laws", [PLOS ONE 15, e0243390 (2020)](https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0243390)
+ - Code: https://github.com/edugalt/scaling
-- Fitting frequency distributions and rank-frequency distributions
-Paper: M. Gerlach and E. G. Altmann, "Stochastic model for the vocabulary growth in natural languages", Phys. Rev. X 3, 021006 (2013)
-Paper: H. H. Chen, T. J. Alexander, D. F.M. Oliveira, E. G. Altmann, "Scaling laws and dynamics of hashtags on Twitter", Chaos 30, 063112 (2020)
-Code: https://github.com/edugalt/TwitterHashtags
+- Fitting frequency distributions and rank-frequency distributions:
+ - Paper: M. Gerlach and E. G. Altmann, "Stochastic model for the vocabulary growth in natural languages", [Phys. Rev. X 3, 021006 (2013)](http://link.aps.org/doi/10.1103/PhysRevX.3.021006)
+ - Paper: H. H. Chen, T. J. Alexander, D. F.M. Oliveira, E. G. Altmann, "Scaling laws and dynamics of hashtags on Twitter", [Chaos 30, 063112 (2020)](https://doi.org/10.1063/5.0004983) or [arXiv](https://arxiv.org/abs/2004.12707)
+ - Code: https://github.com/edugalt/TwitterHashtags
- Effect of correlation
-Paper: M. Gerlach and E. G. Altmann, "Testing statistical laws in complex systems", Phys. Rev. Lett. 122, 168301 (2019)
-Code: https://github.com/martingerlach/testing-statistical-laws-in-complex-systems
+ - Paper: M. Gerlach and E. G. Altmann, "Testing statistical laws in complex systems", [Phys. Rev. Lett. 122, 168301 (2019)](https://doi.org/10.1103/PhysRevLett.122.168301) or [arXiv](https://arxiv.org/abs/1904.11624)
+ - Code: https://github.com/martingerlach/testing-statistical-laws-in-complex-systems
- Constrained surrogates
-Paper: J. M. Moore, G. Yan, E. G Altmann, "Nonparametric Power-Law Surrogates", Phys. Rev. X 12, 021056 (2022)
-Codes: https://github.com/JackMurdochMoore/power-law/
+ - Paper: J. M. Moore, G. Yan, E. G Altmann, "Nonparametric Power-Law Surrogates", [Phys. Rev. X 12, 021056 (2022)](https://doi.org/10.1103/PhysRevX.12.021056)
+ - Code: https://github.com/JackMurdochMoore/power-law/