This repository hosts the documentation for OMERO, and on the develop
branch only, the guidance for contributing developers. The Bio-Formats
documentation is part of the
main Bio-Formats repository
and similarly, other OME projects have their documentation within the same
repository as the code they are documenting.
We welcome contributions from the community to update or improve our documentation but please read the style guidance in the README before opening a PR.
- Fork the repository on Github.
- Create a branch for your work. If you want to make changes for a future major version of
OMERO, this should be based on the
develop
branch. For changes for the current version of OMERO, base your branch on the latestdev_x
branch e.g.dev_5_0
. - Make your commits and open a PR.
- Make sure you explain your changes in the PR description.
We aim to review all PRs within 2 working days. Someone will comment whether the change is fine as-is or request you to make changes before we merge it. If your formatting is incorrect, the Travis build will fail and indicate the problem for you.
If your changes are for the current version of OMERO, one of the docs team
will either ask you to rebase your change onto the develop
branch after
merging, or will do it for you. If you are making a very minor change, you may
open PRs on both branches before review if you wish.