LSSTDESC · vitenti · Nov 27, 2023 · Jul 28, 2023 · Sep 21, 2023 · Sep 21, 2023
diff --git a/docs/Makefile b/docs/Makefile
@@ -18,13 +18,7 @@ help:
 
 TOPTARGETS := all html clean
 
-SUBDIRS = diagrams
-
-$(TOPTARGETS): $(SUBDIRS)
-$(SUBDIRS):
-	$(MAKE) -C $@ $(MAKECMDGOALS)
-
-.PHONY: $(TOPTARGETS) $(SUBDIRS)
+.PHONY: $(TOPTARGETS)
 
 .PHONY: html
 html:
@@ -36,8 +30,3 @@ clean:
 	$(RM) _build/
 	$(RM) _autosummary/
 
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile $(SUBDIRS)
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/docs/basic_usage.rst b/docs/basic_usage.rst
@@ -4,9 +4,6 @@ Using Firecrown
 .. role:: python(code)
    :language: python
 
-
-
-
 The easiest way to get started using Firecrown is to look at the examples.
 These are found in the `examples folder <https://github.com/LSSTDESC/firecrown/tree/master/examples>`_.
 There are examples that show use of each of the supported samplers.

diff --git a/docs/contrib.rst b/docs/contrib.rst
@@ -41,6 +41,11 @@ Testing
     As the coverage improves, we will provide instructions for writing tests for new code.
 
 We are using :bash:`pytest` to run tests on Firecrown.
+To run the same set of tests that will be run by the CI system, use:
+
+.. code:: bash
+
+    python -m pytest
 
 Use of :bash:`pylint`
 ---------------------

diff --git a/docs/diagrams.rst b/docs/diagrams.rst
diff --git a/docs/diagrams/GNUmakefile b/docs/diagrams/GNUmakefile
diff --git a/docs/diagrams/gaussian-family.puml b/docs/diagrams/gaussian-family.puml
diff --git a/docs/diagrams/likelihood.puml b/docs/diagrams/likelihood.puml
diff --git a/docs/diagrams/likelihood_frag.iuml b/docs/diagrams/likelihood_frag.iuml
diff --git a/docs/diagrams/sacc_data.puml b/docs/diagrams/sacc_data.puml
diff --git a/docs/diagrams/skinparams.iuml b/docs/diagrams/skinparams.iuml
diff --git a/docs/diagrams/statistic.puml b/docs/diagrams/statistic.puml
diff --git a/docs/diagrams/statistic_frag.iuml b/docs/diagrams/statistic_frag.iuml
diff --git a/docs/diagrams/twopoint.puml b/docs/diagrams/twopoint.puml
diff --git a/docs/diagrams/typedefs.puml b/docs/diagrams/typedefs.puml
diff --git a/docs/diagrams/updatable.puml b/docs/diagrams/updatable.puml