kayobe/doc/source/contributor/contributing.rst
Mark Goddard f7628d30d7 docs: Move development section under contributor guide
This makes the docs more consistent with other projects.

Change-Id: I75732859a67851df564dc472fa839f08be3367cc
2020-09-21 09:40:54 +00:00

4.1 KiB

So You Want to Contribute...

For general information on contributing to OpenStack, please check out the contributor guide to get started. It covers all the basics that are common to all OpenStack projects: the accounts you need, the basics of interacting with our Gerrit review system, how we communicate as a community, etc.

Below will cover the more project specific information you need to get started with Kayobe.

Basics

The source repository for this project can be found at:

https://opendev.org/openstack/kayobe

Communication

Kayobe shares communication channels with Kolla.

IRC Channel

#openstack-kolla (channel logs) on Freenode

Weekly Meetings

On Wednesdays at 15:00 UTC in the IRC channel (meetings logs)

Mailing list (prefix subjects with [kolla])

http://lists.openstack.org/pipermail/openstack-discuss/

Meeting Agenda

https://wiki.openstack.org/wiki/Meetings/Kolla

Whiteboard (etherpad)

Keeping track of CI gate status, release status, stable backports, planning and feature development status. https://etherpad.openstack.org/p/KollaWhiteBoard

Contacting the Core Team

The list in alphabetical order (on first name):

Name IRC nick Email address
Doug Szumski dougsz doug@stackhpc.com
John Garbutt johnthetubaguy john@johngarbutt.com
Kevin Tibi ktibi kevintibi@hotmail.com
Mark Goddard mgoddard mark@stackhpc.com
Pierre Riteau priteau pierre@stackhpc.com
Will Szumski jovial will@stackhpc.com

The current effective list is also available from Gerrit: https://review.opendev.org/#/admin/groups/1875,members

New Feature Planning

New features are discussed via IRC or mailing list (with [kolla] prefix). Kayobe project keeps RFEs in Storyboard. Specs are welcome but not strictly required.

Task Tracking

Kolla project tracks tasks in Storyboard. Note this is the same place as for bugs.

A more lightweight task tracking is done via etherpad - Whiteboard.

Reporting a Bug

You found an issue and want to make sure we are aware of it? You can do so on Storyboard. Note this is the same place as for tasks.

Getting Your Patch Merged

Most changes proposed to Kayobe require two +2 votes from core reviewers before +W. A release note is required on most changes as well. Release notes policy is described in its own section <release-notes>.

Significant changes should have documentation and testing provided with them.

Project Team Lead Duties

All common PTL duties are enumerated in the PTL guide. Release tasks are described in the Kayobe releases guide <releases>.