Docs

docs/source/dev/index.rst

+Contributing to resolve
+=======================
+
+
+Build the documentation
+-----------------------
+
+To build the documentation from source, install `sphinx
+<https://www.sphinx-doc.org/en/stable/index.html>`_ and the `pydata sphinx theme
+<https://github.com/pydata/pydata-sphinx-theme>`_ on your system and run
+
+.. code-block:: sh
+
+   sh docs/generate.sh

docs/source/index.rst

-Resolve
-=======
+Resolve Manual
+==============
 
-Resolve is a Bayesian radio imaging algorithm.
-
-References
-----------
-
-FIXME
-
-Contents
-........
+Welcome to the resolve documentation!
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   Package Documentation <mod/resolve>
+   User Guide <user/index>
+   API reference <mod/resolve>
+   Development <dev/index>

docs/source/user/index.rst

+
+Resolve user guide
+==================
+
+This guide is an overview and explains the main idea behind resolve. More details
+are found in the `API reference <../mod/resolve.html>`_.