File: documentation.rst

package info (click to toggle)
python-fiscalyear 0.4.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 224 kB
  • sloc: python: 1,362; makefile: 14
file content (21 lines) | stat: -rw-r--r-- 815 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
Documentation
=============

``fiscalyear`` uses `Sphinx <http://www.sphinx-doc.org/en/stable/>`_ and the `Read the Docs Theme <https://docs.readthedocs.io/en/latest/theme.html>`_ to generate its documentation. The documentation is proudly hosted on `Read the Docs <https://readthedocs.org/>`_.


Building the documentation
--------------------------

To build the documentation, you'll need to have ``sphinx`` and ``sphinx_rtd_theme`` installed. Then, ``cd`` to the ``docs`` directory and use the ``Makefile`` to build everything.

.. code-block:: console

   $ cd docs
   $ make html


Continuous Integration (CI)
---------------------------

Every time a change is made to the documentation and pushed to GitHub, Read the Docs automatically rebuilds the documentation, keeping everything in sync and up-to-date.