SSSD Documentation Sources (work in progress)
The documentation is written in reStructuredText format and can be build with Sphinx documentation generator.
Install Python dependencies
It is recommended to install Python dependencies in virtual environment.
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ pip3 install -r requirements.txt
Note: To step out of the virtual environment, run $ deactivate
.
Build it
(.venv) $ make html
View it
$ firefox _build/html/index.html
Example page
There is a sample page that can get you started with reStructuredText. You can view it after the build is finished with:
$ firefox _build/html/example.html
Add new content
- Create a new page in reStructuredText format and include in somewhere in src folder.
- Every new page needs to be part of a page table of content (ToC) tree. To
add a page to the ToC tree, either include it in
toc
directive in an existing document or add it to the top level navigation in the contents document. - Build the documentation with
make html
and navigation to your page to check that everything display as intended. - Open a Pull Request against this repository with your change.