I recently wrote a post called My GitHub cheat sheet for PnP contributions -- an interactive cheat sheet which explains the GitHub commands that I use when I start a contribution. The post is interactive: you just tell it your GitHub username and what repository you want to contribute to, and it customizes the instructions for you.
I also wrote another post talking about how impressed I am with David Warner II's offer to help anyone with their first contribution.
After briefly chatting with David I realized that the biggest hurdle for people is that they just don't know where to get started. In my post, I recommend that you read the contribution guidelines for every repo, but I found that they are often hard to find in each repository.
So, with David's help, we compiled a list of the most common PnP repositories to help you get started.
The list contains the following:
- Repo: Name of the repository
- What is it?: Description of the repository
- Getting started: Links to the most likely resource if you want to get started contributing to that repository
- Branch: The branch you should target when submitting your pull requests
Please note that the information in each of the repositories can change and that you should always refer to the repository for the latest information.
Let's keep this list up to date! If you find that we forgot a repository, or that something is wrong, let us know in the comments of via Twitter and we'll get it updated!
Thanks to David Warner II with putting together this list, and for always making yourself available to help people in this community.
This list wouldn't be possible without the hard work of all of those who contributed (and continue to contribute) to the above repositories. Thank you for your contributions!
- April 03, 2020: Yes, both the SPFx extensions and web parts samples repositories now ask you to submit to the
masterbranch. This article was updated accordingly.
- March 03, 2020: This repository is getting a lot of traffic these days, so I figured I'd update it and add the super-useful microsoft-365-community repo
- November 25, 2019: David Warner II has launched a new initiative to help anyone who wants to create their first PnP contribution. It is called Sharing Is Caring and you can register to attend a live online hands-on session where he walks you through step-by-step instructions to create your first pull request.
- August 25, 2019: Thanks to Bert Jansen for providing us with details for the SharePoint/sp-dev-modernization repository.
- August 23, 2019: Erwin van Hunen Tweeted to remind us about SharePoint/PnP-Sites-Core. It is so foundational to other components, I don't know how we missed it. Urgh! I hate to disappoint someone I hold in such high regard! Sorry!
- August 23, 2019: Waldek Mastykarz rightly pointed out that we forgot the PnPjs repository.