diff --git a/README.md b/README.md
index 7394094b98f4f3c1279ecc9044900fb83d162913..7e516802fc19189adec5331588f63c0974189d74 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,11 @@ continuous gravitational wave (CW) searches.
 
 For documentation, please use the [wiki](https://gitlab.aei.uni-hannover.de/GregAshton/PyFstat/wikis/home).
 
+In the
+[examples](https://gitlab.aei.uni-hannover.de/GregAshton/PyFstat/tree/master/examples),
+we have a number of scripts demonstrating different use cases.
+
+
 ## Installation
 
 ### `python` installation
diff --git a/examples/fully_coherent_search_using_MCMC.py b/examples/MCMC_examples/fully_coherent_search_using_MCMC.py
similarity index 100%
rename from examples/fully_coherent_search_using_MCMC.py
rename to examples/MCMC_examples/fully_coherent_search_using_MCMC.py
diff --git a/examples/semi_coherent_search_using_MCMC.py b/examples/MCMC_examples/semi_coherent_search_using_MCMC.py
similarity index 100%
rename from examples/semi_coherent_search_using_MCMC.py
rename to examples/MCMC_examples/semi_coherent_search_using_MCMC.py
diff --git a/examples/semi_coherent_directed_follow_up.py b/examples/followup_examples/semi_coherent_directed_follow_up.py
similarity index 100%
rename from examples/semi_coherent_directed_follow_up.py
rename to examples/followup_examples/semi_coherent_directed_follow_up.py
diff --git a/examples/using_initialisation.py b/examples/other_examples/using_initialisation.py
similarity index 100%
rename from examples/using_initialisation.py
rename to examples/other_examples/using_initialisation.py