diff --git a/README.md b/README.md
index b384312cf3bfbd65e5b8b247f3c26eabf98d1b24..039e9c62a864ee5d48a9625c578de1076c62f39a 100644
--- a/README.md
+++ b/README.md
@@ -2,4 +2,20 @@
 
 Simple (and not so simple) examples of mapping data with R
 
-You might also like https://git.soton.ac.uk/twr1m15/la_emissions_viz which drives https://rushby.shinyapps.io/LAemissions/
\ No newline at end of file
+You might also like https://git.soton.ac.uk/twr1m15/la_emissions_viz which drives https://rushby.shinyapps.io/LAemissions/
+
+## data
+
+The following example data is provided in this repository:
+
+* Boundary data - for Solent region (various geographies: LA, LSOA, MSOA)
+* Energy - area-based statistics for domestic electricity consumption (LSOA, MSOA)
+* Lookup table for geographies
+
+## rMappingExample
+
+A simple example of mapping using R. Examples use Local Authority (LA) and Middle-layer Super Output Area (MSOA) geography and electricity consumption data (provided in `data` subfolder).
+
+## ONS-open-geography
+
+An example and resources for using the [ONS Open Geography portal](https://geoportal.statistics.gov.uk) to download geographical data and create maps  using `Leaflet` package.
\ No newline at end of file