Writing Documentation¶
We are using sphinix to write our new documentation.
In conf.py
you’ll see that we use the theme from readthedocs.io. That
means you need to install that theme as well as sphinx to build the
documetnation.
Install dependencies for building documentation (Fedora 25)¶
sudo dnf install python3-sphinx python3-sphinx_rtd_theme
Now build the documentation with sphinx¶
[user@host gnome-builder/]$ cd doc
[user@host doc/]$ sphinx-build . _build
[user@host doc/]$ xdg-open _build/index.html
The first command builds the documentation. Pay attention to warnings which will be shown in red. Some of them may be useful to help you track down issues quickly.
To open the documentation with your web browser, use xdg-open _build/index.html
.
Submitting Patches¶
We will accept patches for documentation no matter how you get them to us. However, you will save us a lot of time if you can:
- Create a fork on gitlab.
- Create a merge request on gitlab.