How to contribute
=================

Getting started
---------------

* Read the `OpenStack Developer's Guide
  <https://docs.openstack.org/infra/manual/developers.html#developer-s-guide>`_
* Login to `OpenStack Gerrit <https://review.openstack.org/>`_ using your
  Launchpad ID

  * Sign up your `OpenStack Individual Contributor License Agreement
    <https://review.openstack.org/#/settings/agreements>`_
  * Check that your email is listed in `Gerrit identities
    <https://review.openstack.org/#/settings/web-identities>`_

* Subscribe to Blazar-related projects on
  `OpenStack Gerrit <https://review.openstack.org/>`_. Go to your
  settings and in the watched projects add *openstack/blazar*,
  *openstack/blazar-nova* and *openstack/python-blazarclient*

As all bugs/blueprints are listed in `Blazar Launchpad
<https://launchpad.net/blazar/>`_, you may keep track on them and choose some
to work on.

How to keep in touch with community
-----------------------------------

* If you're not subscribed to `OpenStack general mailing list
  <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack>`_ or to
  `OpenStack development mailing list
  <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>`_, do
  that. Blazar-related emails must be send with **[blazar]** in its subject
* All questions may be asked on our IRC channel #openstack-blazar on
  `freenode <http://freenode.net>`_
* We also have weekly meetings on #openstack-meeting-alt. Please check
  `meeting details <https://wiki.openstack.org/wiki/Meetings/Blazar>`_

Your first commit to Blazar
----------------------------

* Read the `OpenStack development workflow documentation
  <https://docs.openstack.org/infra/manual/developers.html#development-workflow>`_
* Checkout corresponding Blazar repository:
  `blazar <https://git.openstack.org/openstack/blazar>`_,
  `blazar-nova <https://git.openstack.org/openstack/blazar-nova>`_,
  `client <https://git.openstack.org/openstack/python-blazarclient>`_
* Apply and commit your changes
* Make sure all code checkings and tests have passed
* Send your patch to the review
* Monitor status of your change on https://review.openstack.org/#/