============
Contributing
============

The best way to join the community and get involved is to talk with others
online or at a meetup and offer contributions. Here are some of the many
ways you can contribute to the Castellan project:

* Development and Code Reviews
* Bug reporting/Bug fixes
* Wiki and Documentation
* Blueprints/Specifications
* Testing
* Deployment scripts

Before you start contributing take a look at the `Openstack Developers Guide`_.

.. _`Openstack Developers Guide`: https://docs.openstack.org/infra/manual/developers.html

OFTC IRC (Chat)
---------------
You can find Castellaneers in our publicly accessible channel on `OFTC`_
``#openstack-barbican``. All conversations are logged and stored for your
convenience at `eavesdrop.openstack.org`_. For more information regarding
OpenStack IRC channels please visit the `OpenStack IRC Wiki`_.

.. _`OFTC`: https://oftc.net
.. _`OpenStack IRC Wiki`: https://wiki.openstack.org/wiki/IRC
.. _`eavesdrop.openstack.org`: http://eavesdrop.openstack.org/irclogs/
                              %23openstack-barbican/

Launchpad
---------
Like other OpenStack related projects, we utilize Launchpad for our bug
and release tracking.

* `Castellan Launchpad Project`_

.. _`Castellan Launchpad Project`: https://launchpad.net/castellan

.. note::

    Bugs should be filed on Launchpad, not Github.

Source Repository
-----------------
Like other OpenStack related projects, the official Git repository is
available on `Castellan on GitHub`_.

.. _`Castellan on GitHub`: https://github.com/openstack/castellan

Gerrit
------
Like other OpenStack related projects, we utilize the OpenStack Gerrit
review system for all code reviews. If you're unfamiliar with using
the OpenStack Gerrit review system, please review the `Gerrit Workflow`_
wiki documentation.

.. _`Gerrit Workflow`: https://docs.openstack.org/infra/manual/developers.html#development-workflow

.. note::

    Pull requests submitted through GitHub will be ignored.
