.. reach-tools documentation master file. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Reach-Tools Documentation ============================================================================================================= This documentation is generated from the template defined in ``./docsrc/source/index.rst``. This location and file is the place to start creating documentation for your project. reStructured Text ----------------- Since not everybody knows the reStructured Text syntax cold, it does help to have a good reference or two. * `reStructured Text Cheat Sheet`_ NBSphinx -------- Since frequently Jupyter Notebooks are valuable documentation in themselves, using `NBSphinx`_ you can include them directly in the documentation. Just ensure you start the notebook with a markdown cell using a level one header (``# Level One Title``). Contents ======== .. toctree:: :maxdepth: 2 Notebook Template reacher_tools ================================ Example using the `Sphinx Autodoc`_ extension to document the automatically included support library for this project located in ``./src/reacher_tools``. .. autoclass:: reach_tools.Reach :members: .. autoclass:: reach_tools.ReachPoint :members: reach_tools.utils ----------------------------------------------------------- These utilities are included by default to speed up the development process. .. automodule:: reach_tools.utils :members: Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` .. _reStructured Text Cheat Sheet: https://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html .. _NBSphinx: https://nbsphinx.readthedocs.io/en/0.8.8/ .. _Sphinx Autodoc: https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html