The OpenMAMA documentation project has been designed using github pages for a few key reasons:
This page aims to empower you to getting started with contributing documentation with minimal fuss and most of the documentation is taken from the official documentation theme’s website.
For any changes you may want to make, you are best to preview locally before submitting and run your own copy of the website. Don’t worry there are no databases etc. involved so setup is fairly straightforward.
First things first you’re recommended to fork the repository on github. If you don’t already have a github
account, you’ll need to create one, then navigate to https://github.com/OpenMAMA/openmama.github.io
and press the
Fork button to fork your own copy of the repo. This will give you your own independent copy of the repository which you
can do what you like with. You are also recommended to run
git checkout -b descriptive-branch-name-for-your-changes to ensure any
changes that you contribute back are done from an isolated feature branch.
Locally, clone the repository from your fork. (
git clone https://github.com/yourusername/openmama.github.io.git)
To view the OpenMAMA website locally, you can simply install jekyll, then run:
bundle exec jekyll serve
from the root directory of your git clone. Any changes you make should update your local hosted version of the site (default is
and any changes you make should update the site in real time).
Once you are happy, perform the usual git add / commit / push to push your changes back to your own forked repository.
Once you’re happy, navigate to https://github.com/OpenMAMA/openmama.org and you should be presented with an invitation to create a pull request which will lead you to a form which you can fill in detailing the nature of the change. Once this pull request is approved and merged, it will automatically update the live site!