shaker/doc/source/contributing.rst
Ian Wienand ecd88a3967 Replace openstack.org git:// URLs with https://
This is a mechanically generated change to replace openstack.org
git:// URLs with https:// equivalents.

This is in aid of a planned future move of the git hosting
infrastructure to a self-hosted instance of gitea (https://gitea.io),
which does not support the git wire protocol at this stage.

This update should result in no functional change.

For more information see the thread at

 http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003825.html

Change-Id: I37f57d6c8b5c86ea87247dc0220c6030993633ec
2019-03-25 11:38:38 +00:00

1.8 KiB

Contributing

Contribute to Shaker

Shaker follows standard OpenStack contribution workflow as described at

https://docs.openstack.org/infra/manual/developers.html

Start working

  1. Clone the repo:

    $ git clone https://git.openstack.org/openstack/shaker
  2. From the root of your workspace, check out a new branch to work on:

    $ git checkout -b <TOPIC-BRANCH>
  3. Implement your code

Before Commit

  1. Make sure your code works by running the tests:

    $ tox

By default tox executes the same set of tests as configured in Jenkins, i.e.: py34 and py27 unit tests, pep8 style check and documentation build.

  1. If there are any changes in config parameters, also do:

    $ tox -egenconfig

This job updates sample config file as well as documentation on CLI utils.

Submit Review

  1. Commit the code:

    $ git commit -a

Commit message should indicate what the change is, for a bug fix commit it needs to contain reference to Launchpad bug number.

  1. Submit the review:

    $ git review
  2. If the code is approved with a +2 review, Gerrit will automatically merge your code.

Bug Tracking

Bugs are tracked at Launchpad:

https://bugs.launchpad.net/shaker

Developer's Guide of OpenStack

If you would like to contribute to the development of OpenStack, you must follow the steps in this page:

https://docs.openstack.org/infra/manual/developers.html

Once those steps have been completed, changes to OpenStack should be submitted for review via the Gerrit tool, following the workflow documented at:

https://docs.openstack.org/infra/manual/developers.html#development-workflow

Pull requests submitted through GitHub will be ignored.