Contribute
==========

Communication
-------------

Reporting bugs or Features
~~~~~~~~~~~~~~~~~~~~~~~~~~

Security Bugs and Flaws
^^^^^^^^^^^^^^^^^^^^^^^

-  Please inform us about all security-related bugs and flaws before you
   make the information public. It will give us chance to release a
   fixed version before the bug will be widely exploited.
-  Please send all relevant information to `Red Hat Product Security
   Team <https://access.redhat.com/security/team/contact/>`__.
-  FreeIPA team would like to thank Red Hat Product Security Team for
   their hard work!

Tracking
^^^^^^^^

-  We use `Codeberg <https://codeberg.org/freeipa/freeipa>`__ for the upstream
   development, so all RFEs or bug reports should go primarily there.
-  Bugs against released Fedora versions can be logged using the
   following `Bugzilla
   link <https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=freeipa>`__
   (already set to use *freeipa* as a component)
-  Bugs against released Red Hat Enterprise Linux versions of Identity
   Management product can be logged using the following Bugzilla
   `Bugzilla
   link <https://bugzilla.redhat.com/enter_bug.cgi?product=Red%20Hat%20Enterprise%20Linux%208&component=ipa>`__
   (component *ipa*).

Code of Conduct
~~~~~~~~~~~~~~~

Whatever way of communication or contribution mean you choose with the
FreeIPA project, please respect our `Code of
Conduct <https://github.com/freeipa/freeipa/blob/master/CODE_OF_CONDUCT.md>`__.

Mailing Lists
~~~~~~~~~~~~~

FreeIPA development is mostly done via the `freeipa-devel mailing
list <https://lists.fedoraproject.org/archives/list/freeipa-devel@lists.fedorahosted.org/>`__.
You can join at
` <https://lists.fedoraproject.org/archives/list/freeipa-devel@lists.fedorahosted.org/>`__\ https://lists.fedoraproject.org/archives/list/freeipa-devel@lists.fedorahosted.org/.
Feel free to introduce yourself to the list and let us know what areas
of development are you interest in.

Use `freeipa-users mailing
list <https://lists.fedoraproject.org/archives/list/freeipa-users@lists.fedorahosted.org/>`__
to discuss deployment, configuration, and use of FreeIPA. The Users
mailing list is the best place to ask "how to" questions and to share
your experience with FreeIPA.

Subscribe to `freeipa-interest mailing
list <https://lists.fedoraproject.org/archives/list/freeipa-interest@lists.fedorahosted.org/>`__
for low-frequency announcements.

IRC
~~~

We also hang out on the libera.chat IRC servers (irc.libera.chat) in the
*#freeipa* channel.

How Can I Help?
---------------

There are different areas, where FreeIPA project would welcome your
help! Read all the pointers below, if there is anything unclear, feel
free to ask!

How To Start
~~~~~~~~~~~~

The FreeIPA project uses the `Codeberg ticketing
system <https://codeberg.org/freeipa/freeipa>`__ to keep track of work being done.
If you want to contribute check out if there are interesting tickets in
the pipeline (or file your own).

Development
~~~~~~~~~~~

Build and Run
^^^^^^^^^^^^^

See the dedicated :doc:`FreeIPA Build Guide </page/Build>`

Contribute code
^^^^^^^^^^^^^^^

-  :doc:`Contribute code </page/Contribute/Code>` by
   submitting bug fixes or new features. Help us make FreeIPA great!
-  Write a new plugin with a new functionality for FreeIPA and tell us!
   Maybe your plugin will make its way to the FreeIPA main project (see
   :doc:`general considerations </page/General_considerations>`
   that plugin developers should keep in mind).

Translate
^^^^^^^^^

Would you like to see FreeIPA translated to your native language? Become
a translator!

FreeIPA uses `Fedora
Weblate <https://translate.fedoraproject.org/projects/freeipa/>`__
instance for translations, managed by Fedora Project. A Fedora Project
account is needed.

How to translate
''''''''''''''''

-  visit `Becoming a Fedora Translator
   page <https://fedoraproject.org/wiki/L10N/Guide#Becoming_a_Fedora_Translator>`__
   and become Fedora Project translator (please follow the steps listed
   there) (contacting your `L10N language
   team <https://fedoraproject.org/wiki/L10N_Teams>`__ may speed up the
   process)
-  visit `FreeIPA
   Weblate <https://translate.fedoraproject.org/projects/freeipa/>`__
   page, choose your language and translate.
-  all your changes will be included in next FreeIPA release
   automatically. No more actions are required from your side. :-)

Testing
~~~~~~~

Help Us Test
^^^^^^^^^^^^

-  Help us test and verify the project by simply using it in your
   environment.
-  :doc:`Testing page </page/Testing>` is good start
   point and contains the information about execution of existing test
   suites.

Contribute Tests
^^^^^^^^^^^^^^^^

-  :doc:`Contribute tests </page/Contribute/Tests>`
   by creating test plans or writing new automatized tests that can be
   run in :doc:`FreeIPA integration testing </page/V3/Integration_testing>`

Documentation
~~~~~~~~~~~~~

Contribute documentation
^^^^^^^^^^^^^^^^^^^^^^^^

-  :doc:`Help with documenting </page/Contribute/Documentation>`
   new features or adding more information
-  :doc:`Write a How To </page/HowTos>` article
   about integrating FreeIPA with other projects
-  Do not hesitate to ask on IRC or our mailing lists - see section
   `Communication <#communication>`__.
