integrate new tutorials

.github/workflows/test.yml

@@ -314,6 +314,13 @@ jobs:
           python -m pip install .
           wc -l examples/sherpa/.cover* examples/xspec/.cover* docker/testsrc/.cover* .cover* || true
 
+      - name: David Homan's workflow
+        run: |
+          python -m pip install natsort;
+          pushd examples/xspec/bayesian-workflow/tutorials/;
+          bash run_all.sh;
+          popd;
+
       - name: Coverage report
         run: |
           coverage combine examples/sherpa examples/xspec docker/testsrc .

doc/conf.py

@@ -38,7 +38,7 @@
     'sphinx.ext.viewcode',
     'sphinx.ext.mathjax',
     'sphinx.ext.autosectionlabel',
-    #'nbsphinx',
+    'nbsphinx',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
     'sphinx.ext.napoleon',

doc/index.rst

@@ -57,6 +57,8 @@ The usage is similar in Sherpa and Xspec conceptionally:
 
    examples
    xagnfitter
+   ../examples/xspec/bayesian-workflow/tutorials/tutorial_usage_plotbxa.ipynb
+   ../examples/xspec/bayesian-workflow/tutorials/tutorial_usage_plotxspec.ipynb
 
 Indices and tables
 ==================

doc/xspec-analysis.rst

@@ -204,5 +204,8 @@ For Xspec, the *qq* function in the *qq* module allows you to create such plots
 
 .. autofunction:: bxa.xspec.qq.qq
 
-Refer to the :ref:`accompaning paper <cite>`, which gives an introduction and 
-detailed discussion on the methodology.
+For an introduction and detailed discussion on the methodology, see: 
+
+* the :ref:`accompaning paper <cite>`
+* the `book chapter "Statistical Aspects of X-ray Spectral Analysis" <https://arxiv.org/abs/2309.05705>`_
+* the PlotBXA tutorial linked on the left of this page