How you can contribute to this documentation¶
How to modify the webpages¶
With a GitLab account you have two possibilities to edit the sources:
- If you are member of the dalton group, you can push directly to https://gitlab.com/dalton/installguide/. Once you commit and push, a webhook updates the documentation on http://dalton-installation.readthedocs.org/. This typically takes less than a minute.
- You fork https://gitlab.com/dalton/installguide/ and submit your changes at some point via a merge request. This means that your changes are not immediately visible but become so after a team member reviews your changes with a mouse click thus integrating them to https://gitlab.com/dalton/installguide/.
Note that the entire documentation including the entire documentation source code is public. Do not publish sensitive information and harvestable email addresses.
How to locally test changes¶
You do not have to push to see and test your changes. You can test them locally. For this install python-sphinx and python-matplotlib. Then build the pages with:
$ make html
Then point your browser to _build/html/index.html. The style is not the same but the content is what you would see after the git push.