syntribos/doc/source/contributing.rst

1.6 KiB

Contributing Guidelines

Syntribos is an open source project and contributions are always welcome, if you have any questions, we can be found in the #openstack-security channel on Freenode IRC.

  1. Follow all the OpenStack Style Guidelines (e.g. PEP8, Py3 compatibility)

  2. All new classes/functions should have appropriate docstrings in RST format

  3. All new code should have appropriate unittests (place them in the tests/unit folder)

  4. Any change you make can be tested using tox:

    pip install tox tox -e pep8 tox -e py27 tox -e py34 tox -e cover

Anyone wanting to contribute to OpenStack must follow the OpenStack development workflow

All changes should be submitted through the code review process in Gerrit described above. All pull requests on Github will be closed/ignored.

Bugs should be filed on the syntribos launchpad site, and not on Github. All Github issues will be closed/ignored.

Breaking changes, feature requests, and other unprioritized work should first be submitted as a blueprint here for review.

Note: README.rst is auto generated from docs by running python readme.py from the syntribos/scripts directory. So when the README.rst needs to be updated; modify the corresponding rst file in syntribos/doc/source and auto generatoe the README.