diff --git a/getBoundaryData.R b/R/getBoundaryData.R
similarity index 100%
rename from getBoundaryData.R
rename to R/getBoundaryData.R
diff --git a/README.md b/README.md
index 4fd4918a80caf0ea029799bc97fab03688a61b58..917d815cf1c605928b4a0b68f6c43ce1e84ff98f 100644
--- a/README.md
+++ b/README.md
@@ -22,13 +22,19 @@ You link these using the relevant area level codes such as:
 
 ### rMappingExample
 
-A [simple example of mapping using R](rMappingExample.html). Examples use Local Authority (LA) and Middle-layer Super Output Area (MSOA) geography and electricity consumption data (provided in `data` subfolder).
+A [simple example of mapping using R](rMappingExample/rMappingExample.html). Examples using 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](ONS-open-geography.html) for using the [ONS Open Geography portal](https://geoportal.statistics.gov.uk) to download geographical data and create maps  using `Leaflet` package.
+An [example and resources](onsOpenGeography/ONS-open-geography.html) for using the [ONS Open Geography portal](https://geoportal.statistics.gov.uk) to download geographical data and create maps  using `Leaflet` package.
 
-### fun with cartograms
+See the [open-geog-API](open-geog-API) folder for API examples
+
+### LSOA example
+
+What it says [on the tin](/lsoaExample/lsoaExample.html)
+
+### Fun with cartograms
 
 What it says [on the tin](/cartograms/hex-cartograms.html)
 
diff --git a/cartograms/hex-cartograms.R b/funWithCartograms/hex-cartograms.R
similarity index 100%
rename from cartograms/hex-cartograms.R
rename to funWithCartograms/hex-cartograms.R
diff --git a/cartograms/hex-cartograms.Rmd b/funWithCartograms/hex-cartograms.Rmd
similarity index 100%
rename from cartograms/hex-cartograms.Rmd
rename to funWithCartograms/hex-cartograms.Rmd
diff --git a/cartograms/hex-cartograms.html b/funWithCartograms/hex-cartograms.html
similarity index 100%
rename from cartograms/hex-cartograms.html
rename to funWithCartograms/hex-cartograms.html
diff --git a/lsoaExample.Rmd b/lsoaExample/lsoaExample.Rmd
similarity index 100%
rename from lsoaExample.Rmd
rename to lsoaExample/lsoaExample.Rmd
diff --git a/lsoaExample.html b/lsoaExample/lsoaExample.html
similarity index 100%
rename from lsoaExample.html
rename to lsoaExample/lsoaExample.html
diff --git a/ONS-open-geography.Rmd b/onsOpenGeography/ONS-open-geography.Rmd
similarity index 100%
rename from ONS-open-geography.Rmd
rename to onsOpenGeography/ONS-open-geography.Rmd
diff --git a/ONS-open-geography.html b/onsOpenGeography/ONS-open-geography.html
similarity index 100%
rename from ONS-open-geography.html
rename to onsOpenGeography/ONS-open-geography.html
diff --git a/rMappingExample.Rmd b/rMappingExample/rMappingExample.Rmd
similarity index 100%
rename from rMappingExample.Rmd
rename to rMappingExample/rMappingExample.Rmd
diff --git a/rMappingExample.html b/rMappingExample/rMappingExample.html
similarity index 100%
rename from rMappingExample.html
rename to rMappingExample/rMappingExample.html
diff --git a/rMappingExample.pdf b/rMappingExample/rMappingExample.pdf
similarity index 100%
rename from rMappingExample.pdf
rename to rMappingExample/rMappingExample.pdf