Skip to content

Evaluate opportunities to ease the experience of new contributors #2067

Open
@kandersolar

Description

@kandersolar

Is your feature request related to a problem? Please describe.
We hear from pvlib users that unfamiliarity with git/github is sufficient to prevent them from making the jump from user to contributor. Ideally, sufficient documentation would exist to prevent this kind of procedural/tooling barrier from derailing contributions.

Our Contributing page our primary documentation to help people get started with contributing to pvlib. More generally, many resources for learning git/github and open-source contributing are available. Perhaps these guides are insufficient somehow, or perhaps people are not aware of them.

Describe the solution you'd like
Evaluate where and how we can improve our documentation to make first contributions easier. Feedback from people who recently began contributing to open-source projects would be very valuable on this point.

Describe alternatives you've considered
Some community members have suggested recording a video of walking through the process of making a first PR. I see value here, but it may be largely redundant with existing guides elsewhere on the internet, and also risks falling out of date if somehow the contribution process changes (an example: when we switched from master to main).

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions