.. _community:

Contributing to the community
=============================

**Contributions are very welcome!**

This chapter explains how to contribute to ESMValTool.
We greatly value contributions of any kind.
Contributions could include, but are not limited to documentation improvements,
bug reports, new or improved diagnostic code, scientific and technical code
reviews, infrastructure improvements, maintenance of recipes, mailing list and chat participation,
community help/building, education and outreach.

If you have a bug or other issue to report, please open an issue on the
`issues tab on the ESMValTool github
repository <https://github.com/ESMValGroup/ESMValTool/issues>`__.

In case anything is unclear feel free to contact us for more information and
help, e.g. on our
`GitHub Discussions page <https://github.com/ESMValGroup/ESMValTool/discussions>`__.

.. toctree::
   :maxdepth: 1

		Contributing code and documentation <code_documentation>
		Contributing a diagnostic or recipe <diagnostic>
		Policy on backward compatibility <backward_compatibility>
		Broken recipe policy <broken_recipe_policy>
		Contributing a dataset <dataset>
		Supporting multiple dataset versions <multiple_dataset_versions>
		Contributing a review <review>
		Maintaining a recipe <maintainer>
		Upgrading a namelist to a recipe <upgrading>
		GitHub workflow <repository>
		Moving work from the private to the public repository <private_repository>
		Release strategy and procedures <release_strategy/index>