diff --git a/README.rst b/README.rst
index 332cbdd285cc010527c7ca643d9ae7a37f2e503a..47cfb69f5d040f3f5d816ad5045ea48d40a02be0 100644
--- a/README.rst
+++ b/README.rst
@@ -15,39 +15,6 @@ help in creating a merge request, see `this page
 <https://docs.gitlab.com/ee/gitlab-basics/add-merge-request.html>`__ or contact
 us directly.
 
-Examples
---------
-
-To get started with ``tupak``, we have a few examples and tutorials:
-
-1. `Examples of injecting and recovering
-   data <https://git.ligo.org/Monash/tupak/tree/master/examples/injection_examples>`__
-
-   -  `A basic
-      tutorial <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/basic_tutorial.py>`__
-   -  `Create your own source
-      model <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/create_your_own_source_model.py>`__
-   -  `Create your own time-domain source
-      model <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/create_your_own_time_domain_source_model.py>`__
-   -  `How to specify the
-      prior <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/how_to_specify_the_prior.py>`__
-   -  `Using a partially marginalized
-      likelihood <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/marginalized_likelihood.py>`__
-
-2. `Examples using open
-   data <https://git.ligo.org/Monash/tupak/tree/master/examples/open_data_examples>`__
-
-   -  `Analysing the first Binary Black hole detection,
-      GW150914 <https://git.ligo.org/Monash/tupak/blob/master/examples/open_data_examples/GW150914.py>`__
-
-3. `Notebook-style
-   tutorials <https://git.ligo.org/Monash/tupak/tree/master/examples/tutorials>`__
-
-   -  `Comparing different
-      samplers <https://git.ligo.org/Monash/tupak/blob/master/examples/tutorials/compare_samplers.ipynb>`__
-   -  `Visualising the
-      output <https://git.ligo.org/Monash/tupak/blob/master/examples/tutorials/visualising_the_results.ipynb>`__
-
 .. |pipeline status| image:: https://git.ligo.org/Monash/tupak/badges/master/pipeline.svg
    :target: https://git.ligo.org/Monash/tupak/commits/master
 .. |coverage report| image:: https://monash.docs.ligo.org/tupak/coverage_badge.svg
diff --git a/docs/examples.txt b/docs/examples.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4ae32bf8fb3e1d5d0919c952dff62d9b6909b3c2
--- /dev/null
+++ b/docs/examples.txt
@@ -0,0 +1,38 @@
+========
+Examples
+========
+
+1. `General inference examples <https://git.ligo.org/Monash/tupak/tree/master/examples/other_examples>`_
+
+   - `A simple Gaussian likelihood <https://git.ligo.org/Monash/tupak/blob/master/examples/other_examples/gaussian_example.py>`_: a good example to see how to write your own likelihood.
+   - `Linear regression for unknown noise <https://git.ligo.org/Monash/tupak/blob/master/examples/other_examples/linear_regression_unknown_noise.py>`_: fitting to general time-domain data.
+
+2. `Examples of injecting and recovering
+   data <https://git.ligo.org/Monash/tupak/tree/master/examples/injection_examples>`__
+
+   -  `A basic
+      tutorial <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/basic_tutorial.py>`__
+   -  `Create your own source
+      model <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/create_your_own_source_model.py>`__
+   -  `Create your own time-domain source
+      model <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/create_your_own_time_domain_source_model.py>`__
+   -  `How to specify the
+      prior <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/how_to_specify_the_prior.py>`__
+   -  `Using a partially marginalized
+      likelihood <https://git.ligo.org/Monash/tupak/blob/master/examples/injection_examples/marginalized_likelihood.py>`__
+
+3. `Examples using open
+   data <https://git.ligo.org/Monash/tupak/tree/master/examples/open_data_examples>`__
+
+   -  `Analysing the first Binary Black hole detection,
+      GW150914 <https://git.ligo.org/Monash/tupak/blob/master/examples/open_data_examples/GW150914.py>`__
+
+4. `Notebook-style
+   tutorials <https://git.ligo.org/Monash/tupak/tree/master/examples/tutorials>`__
+
+   -  `Comparing different
+      samplers <https://git.ligo.org/Monash/tupak/blob/master/examples/tutorials/compare_samplers.ipynb>`__
+   -  `Visualising the
+      output <https://git.ligo.org/Monash/tupak/blob/master/examples/tutorials/visualising_the_results.ipynb>`__
+
+
diff --git a/docs/index.txt b/docs/index.txt
index 5ec3d4b2db9ce176829d75b82db80d75152d594f..4f0269fc7aabc6b700cfdb9bc2753adad0cbd1fc 100644
--- a/docs/index.txt
+++ b/docs/index.txt
@@ -9,6 +9,7 @@ Welcome to tupak's documentation!
    :caption: Contents:
 
    installation
+   examples
    basics-of-parameter-estimation
    prior
    likelihood