This is the documentation in rst format.
Please review, comment which parts to remove or update.
Or reject PR, pull from fork and cleanup yourself, PR.
The docu can be removed by del /docs folder.
RST documentation needs a little bit effort to test. You need to install some packages. The user don't need.
Pull the "sphinx-docu" branch to the local repo.
Go to /docs/source/config.py and read the doc_string,
or follow:
pip install -U sphinx
pip install sphinx-rtd-theme
pip install sphinxcontrib-napoleon
# Use sphinx-apidoc to build your API documentation:
cd docs
sphinx-apidoc -f -o source/ ../scour/ # for PR done already!
make html
# if you add a rst document, add to index.rst and rerun sphinx-apidoc -f -o source/ ../scour/
#
# create a page, web hook, on readthedocs.org and update manually on docu change
Install sphinx packages, then open a terminal in /docs to execute Makefile: $ make html
open /docs/build/html/index.html
The output is the same as it is shown in readthedocs.org, if you login and create a web hook for the scour repo.
The /docs/buid folder is not needed for the functionality. Just for review.
This is the documentation in rst format. Please review, comment which parts to remove or update. Or reject PR, pull from fork and cleanup yourself, PR. The docu can be removed by del /docs folder.
RST documentation needs a little bit effort to test. You need to install some packages. The user don't need. Pull the "sphinx-docu" branch to the local repo. Go to /docs/source/config.py and read the doc_string, or follow:
Install sphinx packages, then open a terminal in /docs to execute Makefile: $ make html open /docs/build/html/index.html The output is the same as it is shown in readthedocs.org, if you login and create a web hook for the scour repo. The /docs/buid folder is not needed for the functionality. Just for review.
Best regards