explain user and developer notebooks

Author: dilpath

doc/examples.rst

@@ -1,12 +1,19 @@
 Examples
 ========
 
-Various example notebooks.
+There are currently notebooks aimed at users and developers.
+
+Users that are working with PEtab problems should consult the model selection documentation of the calibration tool they wish to use. In this case, there is no need to use the PEtab Select package directly to perform model selection. After model selection, results can be analyzed with PEtab Select. See the API documentation for :mod:`petab_select.analyze`, or the visualization notebook.
+
+Users who wish to apply model selection methods using a calibration tool that doesn't support PEtab can refer to the "other_model_types" notebook for a demonstration using statsmodels.
+
+Developers wishing to implement model selection in their tool via PEtab Select can consult the workflow or "example_cli_famos" notebooks.
 
 .. toctree::
    :maxdepth: 1
 
-   examples/example_cli_famos.ipynb
    examples/visualization.ipynb
+   examples/other_model_types.ipynb
+   examples/example_cli_famos.ipynb
    examples/workflow_cli.ipynb
    examples/workflow_python.ipynb