diff --git a/source/developer-guide/documentation/index.rst b/source/developer-guide/documentation/index.rst index 005f033b..71c83b12 100644 --- a/source/developer-guide/documentation/index.rst +++ b/source/developer-guide/documentation/index.rst @@ -1,75 +1,73 @@ ================================= Contributing to the Documentation ================================= This documentation can easily be contributed to by cloning the following git repository. https://git.kolab.org/diffusion/D/ -https://kolab.org/blog/timotheus-pokorra/2015/07/01/submitting-patches-kolab-phabricator - .. IMPORTANT:: The documentation is only as good as your willingness to contribute to it. Other documentation included here: .. toctree:: :maxdepth: 1 writing-documentation todolist Building the Documentation ========================== Most of our more regular contributors clone the repository to their local workstation, and then build the documentation before pushing back changes to their fork of kolab-docs. To build the documentation, you need to have `Sphinx`_ installed. You can also find some hints, tips and tricks on their website, with regards to the `reStructuredText`_ format the documentation is written in. #. Naturally, first clone the git repository. .. parsed-literal:: $ :command:`git clone https://git.kolab.org/diffusion/D/docs.git` #. Navigate in to the fresh clone: .. parsed-literal:: $ :command:`cd kolab-docs` #. To build for real, and possibly also publish the results, pull in the sub-projects we include in to our builds. Executing this step is not necessary, but gives you the complete set of documentation as is published on `docs.kolab.org`_. .. parsed-literal:: $ :command:`git submodule init` $ :command:`git submodule update` .. seealso:: * `Working with Git Submodules`_ #. Make your changes and then commit them: .. parsed-literal:: $ :command:`git commit -a` #. Push your changes back into our Phabricator instance. Timotheus wrote `a good tutorial on how to do that `__. -Enjoy: +Enjoy and thanks for contributing to Kolab! .. _Sphinx: http://sphinx-doc.org/ .. _reStructuredText: http://sphinx-doc.org/rest.html .. _Working with Git Submodules: http://git-scm.com/book/en/Git-Tools-Submodules .. _docs.kolab.org: https://docs.kolab.org