ironic/doc/source/contributor/community.rst
Dmitry Tantsur 2c3470353d Split a community page out of the contributor docs
We need a simple "how to reach out to us" page that is not mixed with
code contribution guide. This change adds it by moving information
around and polishing it a bit.

Change-Id: I0a458c3baddaaa2226cd2105d6325025a0c81f05
2021-06-15 16:47:11 +02:00

86 lines
2.6 KiB
ReStructuredText

====================
Bare Metal Community
====================
This document provides information on how to reach out to the community for
questions, bug reports or new code contributions.
Useful Links
============
Bug/Task tracker
https://storyboard.openstack.org/#!/project/openstack/ironic
Code Hosting
https://opendev.org/openstack/ironic
Code Review
https://review.opendev.org/#/q/status:open+project:openstack/ironic,n,z
Weekly Meeting Agenda
https://wiki.openstack.org/wiki/Meetings/Ironic#Agenda_for_next_meeting
Asking Questions
================
There are two many venues where all discussions happen: IRC and mailing lists.
Internet Relay Chat 'IRC'
-------------------------
Daily contributor discussions take place on IRC in the ``#openstack-ironic``
channel on the OFTC IRC network. Please feel free to connect to
``ircs://irc.oftc.net:6697`` and join our channel!
Note that while we have community members from everywhere in the world, we're
the most active from roughly 6am to 12am. If you don't get an answer to your
question, try the `Mailing list`_.
Additional information on getting connected can be found in the
`OpenStack community contribution guide <https://docs.openstack.org/contributors/common/irc.html>`_.
Mailing list
------------
We use the *openstack-discuss* mailing list for asynchronous communications and
longer discussions. Navigate to
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss
to subscribe or view the archives.
When sending a message please prefix the *Subject* line with ``[ironic]`` so
that we don't miss it.
Reporting Bugs
==============
LaunchPad
---------
Most of the tools used for OpenStack require a Launchpad_ ID for
authentication. Ironic previously used to track work on Launchpad,
but we have not done so since migrating to Storyboard_.
.. _Launchpad: https://launchpad.net
Storyboard
----------
The ironic project moved from Launchpad to `StoryBoard
<https://storyboard.openstack.org/>`_ for work and task tracking.
This provides an aggregate view called a "Project Group"
and individual "Projects". A good starting place is the
`project group <https://storyboard.openstack.org/#!/project_group/ironic>`_
representing the whole of the ironic community, as opposed to
the `ironic project <https://storyboard.openstack.org/#!/project/943>`_
storyboard which represents ironic as a repository.
See :doc:`bugs` for more details on how we track bugs.
Contributing Code
=================
.. seealso::
* :doc:`contributing` - basic information on new code contributions
* :doc:`/contributor/index`