docs: make dirhtml

Author: casperdcl

docs/source/developer_guide.rst

@@ -98,10 +98,9 @@ a HTTP server to view the documentation.
 #. Update conda with ``conda update -n base -c defaults conda``
 #. Follow the instructions `here <https://github.com/TomographicImaging/CIL/tree/master#building-cil-from-source-code>`_ to create a conda environment and build ``cil`` from source
 #. Go to ``docs`` folder
-#. Install packages from ``docs/docs_environment.yml`` (with 'name' changed to ENVIRONMENT_NAME) using ``conda env update -f docs_environment.yml``
-#. Download the notebooks for rendering in the documentation with ``python mkdemos.py``
-#. Build the documentation ``sphinx-build -b dirhtml source build``
-#. Start a HTTP server to serve documentation with ``python -m http.server --directory build``
+#. Install packages from ``docs/docs_environment.yml``
+#. Build the documentation with ``make dirhtml``
+#. Start an HTTP server with ``make serve`` to access the docs via `localhost:8000 <http://localhost:8000>`_.
 
 Example:
 ::
@@ -115,14 +114,12 @@ Example:
   cd docs
   conda update -n base -c defaults conda
   conda env update -f docs_environment.yml # with the name field set to ENVIRONMENT_NAME
-  python mkdemos.py
-  sphinx-build -b dirhtml source build
-  python -m http.server -d build
+  make dirhtml serve
 
 Notebooks gallery
 -----------------
 
-The ``mkdemos.py`` script:
+The ``mkdemos.py`` script (called by ``make dirhtml``):
 
 - downloads notebooks from external URLs to ``source/demos/*.ipynb``
 - uses the ``demos-template.rst`` file to generate the gallery in ``source/demos.rst``
@@ -136,8 +133,8 @@ Make sure that each contributed file contains the following text enclosed in the
 
 ::
 
-  Copyright 2022 United Kingdom Research and Innovation
-  Copyright 2022 The University of Manchester
+  Copyright [yyyy] United Kingdom Research and Innovation
+  Copyright [yyyy] The University of Manchester
   Copyright [yyyy] [name of copyright owner]
   Author(s): [Author name, Author email (optional)]
   Licensed under the Apache License, Version 2.0 (the "License");