.. _community:

Community resources
===================

We have a small community, but we're happy to talk to you.

Community members in all community spaces and beyond are expected to act in
accordance with the :ref:`conduct`.

.. toctree::
   :maxdepth: 1
   :caption: Contents

   conduct
   evangelism

Mailing lists
-------------

.. note::

   All mailing lists require the use of `plain-text email
   <https://useplaintext.email>`_.

hare-announce
~~~~~~~~~~~~~

All Hare users are encouraged to subscribe to the hare-announce mailing list
to receive important updates regarding changes to the Hare language, release
announcements, and security advisories.

* `Archives <https://lists.sr.ht/~sircmpwn/hare-announce>`__
* `Subscribe (mailto:) <mailto:~sircmpwn/hare-announce+subscribe@lists.sr.ht>`__

hare-users
~~~~~~~~~~

The hare-users mailing list is used for end-user support, questions, and
general discussion of Hare.

* `Archives <https://lists.sr.ht/~sircmpwn/hare-users>`__
* `Subscribe (mailto:) <mailto:~sircmpwn/hare-users+subscribe@lists.sr.ht>`__
* `Post (mailto:) <mailto:~sircmpwn/hare-users@lists.sr.ht>`__

hare-dev
~~~~~~~~

Development discussion takes place on hare-dev, as well as patches for the Hare
toolchain and standard and extended libraries.

* `Archives <https://lists.sr.ht/~sircmpwn/hare-dev>`__
* `Subscribe (mailto:) <mailto:~sircmpwn/hare-dev+subscribe@lists.sr.ht>`__
* `Post (mailto:) <mailto:~sircmpwn/hare-dev@lists.sr.ht>`__

hare-rfc
~~~~~~~~

Larger changes proposed for the Hare programming language are discussed using
the :ref:`rfc` on hare-rfc.

* `Archives <https://lists.sr.ht/~sircmpwn/hare-rfc>`__
* `Subscribe (mailto:) <mailto:~sircmpwn/hare-rfc+subscribe@lists.sr.ht>`__
* `Post (mailto:) <mailto:~sircmpwn/hare-rfc@lists.sr.ht>`__

IRC channels
------------

We meet for real-time chat on `libera.chat <https://libera.chat>`_ in various
channels:

* `#hare <irc://irc.libera.chat/#hare>`_: Questions and general discussion
  about Hare.
* `#hare-dev <irc://irc.libera.chat/#hare-dev>`_: Discussion about Hare
  development.
* `#hare-soc <irc://irc.libera.chat/#hare-soc>`_: Social channel, for light
  off-topic discussion.

Fediverse
---------

.. raw:: html

   <p>We have a community-maintained presence on the Fediverse supernetwork at
   <a href="https://fosstodon.org/@hare" rel="me">@hare@fosstodon.org</a>.
   Follow us from any Fediverse server for Hare news and updates.</p>