/ Python / experiments / typexps / docs / index.rst
index.rst
 1  =======
 2  typexps
 3  =======
 4  
 5  This is the documentation of **typexps**.
 6  
 7  .. note::
 8  
 9      This is the main page of your project's `Sphinx`_ documentation.
10      It is formatted in `reStructuredText`_. Add additional pages
11      by creating rst-files in ``docs`` and adding them to the `toctree`_ below.
12      Use then `references`_ in order to link them from this page, e.g.
13      :ref:`authors` and :ref:`changes`.
14  
15      It is also possible to refer to the documentation of other Python packages
16      with the `Python domain syntax`_. By default you can reference the
17      documentation of `Sphinx`_, `Python`_, `NumPy`_, `SciPy`_, `matplotlib`_,
18      `Pandas`_, `Scikit-Learn`_. You can add more by extending the
19      ``intersphinx_mapping`` in your Sphinx's ``conf.py``.
20  
21      The pretty useful extension `autodoc`_ is activated by default and lets
22      you include documentation from docstrings. Docstrings can be written in
23      `Google style`_ (recommended!), `NumPy style`_ and `classical style`_.
24  
25  
26  Contents
27  ========
28  
29  .. toctree::
30     :maxdepth: 2
31  
32     Overview <readme>
33     Contributions & Help <contributing>
34     License <license>
35     Authors <authors>
36     Changelog <changelog>
37     Module Reference <api/modules>
38  
39  
40  Indices and tables
41  ==================
42  
43  * :ref:`genindex`
44  * :ref:`modindex`
45  * :ref:`search`
46  
47  .. _toctree: https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html
48  .. _reStructuredText: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
49  .. _references: https://www.sphinx-doc.org/en/stable/markup/inline.html
50  .. _Python domain syntax: https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#the-python-domain
51  .. _Sphinx: https://www.sphinx-doc.org/
52  .. _Python: https://docs.python.org/
53  .. _Numpy: https://numpy.org/doc/stable
54  .. _SciPy: https://docs.scipy.org/doc/scipy/reference/
55  .. _matplotlib: https://matplotlib.org/contents.html#
56  .. _Pandas: https://pandas.pydata.org/pandas-docs/stable
57  .. _Scikit-Learn: https://scikit-learn.org/stable
58  .. _autodoc: https://www.sphinx-doc.org/en/master/ext/autodoc.html
59  .. _Google style: https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings
60  .. _NumPy style: https://numpydoc.readthedocs.io/en/latest/format.html
61  .. _classical style: https://www.sphinx-doc.org/en/master/domains.html#info-field-lists