diff --git a/README.md b/README.md
index a350bca90d63143bb0208b2c184ad81deb2a3b98..c6ecf2f0f5d61b357bacad0163195b50eacf7305 100644
--- a/README.md
+++ b/README.md
@@ -3,29 +3,26 @@ Docstring coverage:
 ![docstring coverage](./badges/docstring_coverage.svg)
 Test coverage: 
 ![test coverage](./badges/test_coverage.svg)
- [![astropy](http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat)](http://www.astropy.org/) 
+
+Powered by:
+![![astropy](http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat)](http://www.astropy.org/) 
+
 Binary population synthesis code that interfaces with binary_c. Based on a original work by Jeff Andrews. Updated and extended for Python3 by David Hendriks, Robert Izzard.
 
 The current release is version [version](VERSION), make sure to use that version number when installing!
 
-## Requirements
-To run this code you need to at least have installations of:
+## Installation
+To install binary_c-python we need to make sure we meet the requirements of installation, and 
 
-- Python 3.6 or higher
-- binary_c version 2.1.7 or higher
+### Python requirements
+To run this code you need to at least have installations of:
 
-And the following python packages (which will get installed automatically when installing with pip):
+- Python 3.7 or higher (3.6 is EOL, and we are using 3.9 for development)
+- binary_c version 2.2.0 or higher
 
-- numpy
-- pytest
-- h5py
-- pathos
-- pandas
-- astropy
-- matplotlib
-- py_rinterpolate
+The packages that are required for this code to run are listed in the requirements.txt, which automatically gets read out by setup.py
 
-## Environment variables
+### Environment variables
 Before compilation you need to have certain environment variables:
 
 Required:
@@ -35,8 +32,8 @@ Required:
 - `LIBRARY_PATH` should include whatever directories are required to build binary_c (e.g. locations of libgsl, libmemoize, librinterpolate, etc.)
 - `GSL_DIR` should point to the root location where you installed GSL to. This root dir should contain `bin/`, `lib/` etc
 
-## Build instructions
-First, make sure you have built binary_c (See `$BINARY_C/doc/binary_c2.pdf` section: installation for all the installation instructions for `binary_c`)) and that it functions correctly. 
+### Build instructions
+First, make sure you have built binary_c (See `$BINARY_C/doc/binary_c2.pdf` section: installation for all the installation instructions for `binary_c`)) and that it functions correctly.
 
 ### Installation via PIP:
 To install this package via pip:
@@ -44,14 +41,15 @@ To install this package via pip:
 ```
 pip install binarycpython
 ```
-This will install the latest stable installation that is available on pip.
+
+This will install the latest stable installation that is available on Pip. The version on the master branch should be the same version as the latest stable version on Pip
 
 ### Installation from source:
 We can also install the package from source, which is useful for development versions and when you want to modify the code. It is recommended that you install this into a virtual environment. From within the root directory, run 
 ```
 ./install.sh
 ```
-This will install the package, along with all the dependencies.
+This will install the package, along with all the dependencies, into the current active (virtual) python environment.
 
 If this is not the first time you install the package, but rather rebuild it because you made changes in either binary_c or binarycpython, you can run
 ```
@@ -61,14 +59,16 @@ to reinstall just binarycpython.
 
 #### After installation
 After installing the code via source it is useful to run the test suite before doing any programming with it. The test suite is stored in `binarycpython/tests` and running `python main.py` in there will run all the tests. 
-
-## Examples
+	
+	
+## Usage
+### Examples
 See the examples/ directory for example scripts and notebooks. The documentation contains example pages as well. 
 
-## Usage notes
+### Usage notes
 Make sure that with every change/recompilation you make in `binary_c`, you also rebuild this package. Whenever you change the sourcecode of this package, you need to reinstall it into your virtualenvironment as well
 
-## Documentation
+### Documentation
 Look in the docs/ directory. Within the build/html/ there is the html version of the documentation. The 
 
 ## Development:
@@ -78,7 +78,11 @@ If you want to contribute to the code, then it is recommended that you install t
 pip install -r development_requirements.txt
 ```
 
+Please do not hesitate to contact us to discuss any developments. 
+
 ## FAQ/Issues:
+Here we provide a non-exhaustive list of some issues we encountered and solutions for these: 
+
 Building issues with binary_c itself: 
 - see the documentation of binary_c (in doc/). 
 - If you have MESA installed, make sure that the `$MESASDK_ROOT/bin/mesasdk_init.sh` is not sourced. It comes with its own version of some programs, and those can interfere with installing.  
diff --git a/setup.py b/setup.py
index f58d473c9b14bebe8441cb68d855be10ec88d193..2998eb677bb701a667e1b75a17c053193358aaf5 100644
--- a/setup.py
+++ b/setup.py
@@ -261,7 +261,7 @@ setup(
         "binarycpython.tests",
         "binarycpython.tests.tests_population_extensions",
     ],
-    install_requires=[
+    install_requires=[ # TODO: can we centralise this?
         "astropy",
         "cachetools",
         "colorama",