=========
Community
=========

The Hypothesis community is small for the moment but is full of excellent people
who can answer your questions and help you out. Please do join us.
The two major places for community discussion are:

* `The mailing list <https://groups.google.com/forum/#!forum/hypothesis-users>`_.
* An IRC channel, #hypothesis on freenode, which is more active than the mailing list.

Feel free to use these to ask for help, provide feedback, or discuss anything remotely
Hypothesis related at all.  If you post a question on StackOverflow, please use the
`python-hypothesis <https://stackoverflow.com/questions/tagged/python-hypothesis>`__ tag!

Please note that `the Hypothesis code of conduct <https://github.com/HypothesisWorks/hypothesis/blob/master/CODE_OF_CONDUCT.rst>`_
applies in all Hypothesis community spaces.

If you would like to cite Hypothesis, please consider `our suggested citation
<https://github.com/HypothesisWorks/hypothesis/blob/master/CITATION>`_.

If you like repo badges, we suggest the following badge, which you can add
with reStructuredText or Markdown, respectively:

.. image:: https://img.shields.io/badge/hypothesis-tested-brightgreen.svg

.. code:: restructuredtext

    .. image:: https://img.shields.io/badge/hypothesis-tested-brightgreen.svg
       :alt: Tested with Hypothesis
       :target: https://hypothesis.readthedocs.io

.. code:: md

    [![Tested with Hypothesis](https://img.shields.io/badge/hypothesis-tested-brightgreen.svg)](https://hypothesis.readthedocs.io/)

Finally, we have a beautiful logo which appears online, and often on stickers:

.. image:: ../../brand/dragonfly-rainbow.svg
   :alt: The Hypothesis logo, a dragonfly with rainbow wings
   :align: center
   :width: 50 %

As well as being beautiful, dragonflies actively hunt down bugs for a living!
You can find the images and a usage guide in the :gh-file:`brand` directory on
GitHub, or find us at conferences where we often have stickers and sometimes
other swag.
