sahara/doc/source/contributor/how-to-participate.rst
Luigi Toscano 5662d84690 doc: point to the main git repository and update links
- no need to refer to github; point to the main repositories
  on git.openstack.org and remove the requirement for a github
  account in order to contribute;
- update few links which have been moved around and fix at least
  the associated message of a link;
- link to the website for HTTPie.

Change-Id: Ib310815d346e2364de1a2282f3f1e2d94590c3d2
2017-08-21 15:15:47 +02:00

71 lines
2.4 KiB
ReStructuredText

How to Participate
==================
Getting started
---------------
* Make sure that your local git is properly configured by executing
``git config --list``. If not, configure ``user.name``, ``user.email``
* Create account on `Launchpad <https://launchpad.net/sahara>`_
(if you don't have one)
* Subscribe to `OpenStack general mail-list <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack>`_
* Subscribe to `OpenStack development mail-list <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>`_
* Create `OpenStack profile <https://www.openstack.org/profile/>`_
* Login to `OpenStack Gerrit <https://review.openstack.org/>`_ with your
Launchpad id
* Sign `OpenStack Individual Contributor License Agreement <https://review.openstack.org/#/settings/agreements>`_
* Make sure that your email is listed in `identities <https://review.openstack.org/#/settings/web-identities>`_
* Subscribe to code-reviews. Go to your settings on http://review.openstack.org
* Go to ``watched projects``
* Add ``openstack/sahara``, ``openstack/sahara-extra``,
``openstack/python-saharaclient``, and ``openstack/sahara-image-elements``
How to stay in touch with the community
---------------------------------------
* If you have something to discuss use
`OpenStack development mail-list <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>`_.
Prefix the mail subject with ``[Sahara]``
* Join ``#openstack-sahara`` IRC channel on `freenode <http://freenode.net/>`_
* Attend Sahara team meetings
* Weekly on Thursdays at 1400 UTC and 1800 UTC (on alternate weeks)
* IRC channel: ``#openstack-meeting-alt`` (1800UTC) or
``#openstack-meeting-3`` (1400UTC)
* See agenda at https://wiki.openstack.org/wiki/Meetings/SaharaAgenda
How to post your first patch for review
---------------------------------------
* Checkout Sahara code from `its repository <https://git.openstack.org/cgit/openstack/sahara>`_
* Carefully read http://docs.openstack.org/infra/manual/developers.html#development-workflow
* Pay special attention to http://docs.openstack.org/infra/manual/developers.html#committing-a-change
* Apply and commit your changes
* Make sure that your code passes ``PEP8`` checks and unit-tests.
See :doc:`development-guidelines`
* Post your patch for review
* Monitor the status of your patch review on https://review.openstack.org/#/