Introduction to contributing#
Encouraging more people to help develop pvlib-python is essential to our success. Therefore, we want to make it easy and rewarding for you to contribute.
There is a lot of material in this section, aimed at a variety of contributors from novice to expert. Don’t worry if you don’t (yet) understand parts of it.
Core guidelines#
While we welcome new contributors, reviewer capacity is limited. Therefore, following these core guidelines is essential:
Pull requests (PRs) should address one or more open issues. Context should be provided, e.g. a link to the relevant discussion.
GSoC: For Google Summer of Code, we invite applications only from those with PV modeling experience and who are motivated to join the pvlib maintenance team.
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#
Here are a few ideas for how you can contribute, even if you are new to pvlib-python, git, or Python:
Ask and answer pvlib questions on StackOverflow and participate in discussions in the pvlib-python google group.
Make GitHub issues and contribute to the conversations about how to resolve them.
Read issues and pull requests that other people created and contribute to the conversation about how to resolve them. Look for issues tagged with good first issue, easy, or help wanted.
Improve the documentation and the unit tests.
Improve the Example Gallery or add new examples that demonstrate how to use pvlib-python in your area of expertise.
Tell your friends and colleagues about pvlib-python.
Add your project to our Projects and publications that use pvlib-python wiki.
This documentation#
If this documentation is unclear, help us improve it! Consider looking at the pandas documentation for inspiration.
Code of Conduct#
All contributors are expected to adhere to the Contributor Code of Conduct.