diff --git a/docs/sphinx/source/contributing/introduction_to_contributing.rst b/docs/sphinx/source/contributing/introduction_to_contributing.rst index 0eb9d97e4b..f2d262991d 100644 --- a/docs/sphinx/source/contributing/introduction_to_contributing.rst +++ b/docs/sphinx/source/contributing/introduction_to_contributing.rst @@ -12,6 +12,27 @@ contributors from novice to expert. Don't worry if you don't (yet) understand parts of it. +.. _core-guidelines: + +Core guidelines +~~~~~~~~~~~~~~~ +While we welcome new contributors, reviewer capacity is limited. Therefore, +following these core guidelines is essential: + +* Every pull request (PR) should address one or more open issues. The PR should + be outlined in the issue discussion. +* GSoC: For Google Summer of Code, we invite applications only from those with + significant PV modeling experience and who are motivated to join the pvlib + maintenance teams +* pvlib-python is an advanced scientific modeling toolbox. A background + in solar energy and/or experience in pvlib-python is required to + address some issues effectively. It is not always clear which issues + fall into this bucket. Don't be offended if maintainers close your PR for + this reason. +* Maintainers reserve the right to close PRs that do not comply with the + contributing guidelines. + + .. _easy-ways-to-contribute: Easy ways to contribute diff --git a/docs/sphinx/source/whatsnew/v0.15.1.rst b/docs/sphinx/source/whatsnew/v0.15.1.rst index 75ab242c94..19a87fe1cd 100644 --- a/docs/sphinx/source/whatsnew/v0.15.1.rst +++ b/docs/sphinx/source/whatsnew/v0.15.1.rst @@ -53,6 +53,8 @@ Documentation * Fix a broken docstring reference to ``grounddiffuse`` in :py:func:`pvlib.irradiance.poa_components` (:issue:`2089`, :pull:`2708`) +* Add :ref:`core-guidelines` to the :ref:`introduction-to-contributing` page. + (:issue:`2716`, :pull:`2726`) Testing