Contacts
********

GitHub
======

We use `GitHub <https://github.com/roc-streaming/roc-toolkit>`_ for bug tracking and code review. Feel free to file an issue to report a bug, suggest a feature, or discuss an idea. Pull requests are more than welcome! See :doc:`/development/contribution_guidelines`.

There is also a forum and Q&A board on `GitHub discussions <https://github.com/roc-streaming/roc-toolkit/discussions>`_. Welcome!

.. _mailing_list:

Mailing list
============

We have an announcement and discussion mailing list for users and developers: roc@freelists.org. It is the recommended place for extensive discussions and troubleshooting.

You can browse the list archive and join the list by visiting `this page <https://www.freelists.org/list/roc>`__. You can also join the list by sending an email to roc-request@freelists.org with "subscribe" in the "Subject" field.

There is also an `RSS feed <https://www.freelists.org/feed/roc>`_ for the list.

.. note::

   You need to join to be able to post.

.. note::

   Please use `bottom-posting <http://www.idallen.com/topposting.html>`_ on the mailing list.

Matrix chats
============

We also have matrix rooms for more interactive discussion:

* ``#roc-streaming:matrix.org`` - user chat (`web link <https://app.element.io/#/room/#roc-streaming:matrix.org>`__)
* ``#roc-streaming-dev:matrix.org`` - developer chat (`web link <https://app.element.io/#/room/#roc-streaming-dev:matrix.org>`__)

You can open the chat right in your browser using web links above, or you can `install Element <https://element.io/download>`_ (a popular matrix client) to desktop or mobile device. Except Element, there are plenty of other `matrix clients <https://matrix.org/clients/>`_.

.. note::

   You need to setup Matrix account to be able to join the room.
