summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/contributing.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/contributing.rst b/docs/contributing.rst
index a2e4251..49e53ed 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -121,6 +121,26 @@ And you can run the tests with pytest::
If you want to edit settings, you can edit the ``.env`` file.
+Building Documentation
+----------------------
+
+We are using `Sphinx <https://www.sphinx-doc.org/en/master/index.html>`_ and `reStructuredText markup language <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html>`_ to write documentation.
+
+To build documentation, we need to install additional libraries::
+
+ pip install -r docs/requirements.txt
+
+After editing documentation, you can build documentation with the following command::
+
+ make docs
+
+This outputs HTML files under the ``docs/_build/html/`` directory. Let's launch a development server to serve HTML files::
+
+ python -m http.server 8000 --directory docs/_build/html/
+
+Now, you can view the documentation on your browser at http://localhost:8000/.
+
+
Coding Guidelines
-----------------