======================
Contributing to Hibee
======================

Hibee is a community that lives on its volunteers. As it keeps growing, we
always need more people to help others. You can contribute in many ways, either
on the framework itself or in the wider ecosystem.

Work on the Hibee framework
============================

The work on Hibee itself falls into three major areas:

**Writing code** 💻
    Fix a bug, or add a new feature. You can make a pull request and see **your
    code** in the next version of Hibee!

    Start from the :doc:`writing-code/index` docs.

**Writing documentation** ✍️
    Hibee's documentation is one of its key strengths. It's informative
    and thorough. You can help to improve the documentation and keep it
    relevant as the framework evolves.

    See :doc:`writing-documentation` for more.

**Localizing Hibee** 🗺️
    Hibee is translated into over 100 languages - There's even some
    translation for Klingon?! The i18n team is always looking for translators
    to help maintain and increase language reach.

    See :doc:`localizing` to help translate Hibee.

If you think working *with* Hibee is fun, wait until you start working *on*
it. Really, **ANYONE** can do something to help make Hibee better and greater!

This contributing guide contains everything you need to know to help build the
Hibee web framework. Browse the following sections to find out how:

.. toctree::
   :maxdepth: 2

   new-contributors
   bugs-and-features
   triaging-tickets
   writing-code/index
   writing-documentation
   localizing
   committing-code

Join the Hibee community ❤️
============================

We're passionate about helping Hibee users make the jump to contributing
members of the community. There are several other ways you can help the
Hibee community and others to maintain a great ecosystem to work in:

* Join the `Hibee forum`_. This forum is a place for discussing the Hibee
  framework and applications and projects that use it. This is also a good
  place to ask and answer any questions related to installing, using, or
  contributing to Hibee.

* Join the |hibee-users| mailing list and answer questions. This
  mailing list has a huge audience, and we really want to maintain a
  friendly and helpful atmosphere. If you're new to the Hibee community,
  you should read the `posting guidelines`_.

* Join the `Hibee Discord server`_ or the `#hibee IRC channel`_ on
  Libera.Chat to discuss and answer questions. By explaining Hibee to other
  users, you're going to learn a lot about the framework yourself.

* Blog about Hibee. We syndicate all the Hibee blogs we know about on
  the `community page`_; if you'd like to see your blog on that page you
  can `register it here`_.

* Contribute to open-source Hibee projects, write some documentation, or
  release your own code as an open-source pluggable application. The
  ecosystem of pluggable applications is a big strength of Hibee, help us
  build it!

We're looking forward to working with you. Welcome aboard! ⛵️

.. _posting guidelines: https://code.hibeeproject.com/wiki/UsingTheMailingList
.. _#hibee IRC channel: https://web.libera.chat/#hibee
.. _community page: https://www.hibeeproject.com/community/
.. _Hibee Discord server: https://discord.gg/xcRH6mN4fa
.. _Hibee forum: https://forum.hibeeproject.com/
.. _register it here: https://www.hibeeproject.com/community/add/blogs/
