Introduction

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.

I also say that most repositories want you to start from the dev branch, but as the Chris Kent pointed out in yesterday's PnP community call, some repositories prefer you use the master branch.

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.

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!

Popular repositories

RepoWhat is it?Getting startedBranch
SharePoint/PnP-PowerShellSharePoint PnP PowerShell CmdLets https://aka.ms/sppnp-powershellContribution guidancedev
SharePoint/sp-dev-docsSharePoint Developer Documentation https://docs.microsoft.com/en-us/sharepoint/dev/Contribute to SharePoint developer documentationmaster
SharePoint/sp-dev-fx-controls-reactReusable React controls for SPFx solutions https://sharepoint.github.io/sp-dev-fx-controls-react/- Contribution guidelines
- Submitting a PR
dev
SharePoint/sp-dev-fx-extensionsCode samples and developer content targeted towards SharePoint Framework client-side extensions. http://dev.office.com/sharepointContribution guidanceCreate from:master
Submit to: dev
SharePoint/sp-dev-fx-library-componentsSample solutions from community around the SharePoint Framework library componentContribution guidanceCreate from: master
Submit to: dev
SharePoint/sp-dev-fx-property-controlsReusable SPFx property pane controls - Open source initiative https://sharepoint.github.io/sp-dev-fx-property-controls/- Contribution guidelines
- Submitting a PR
dev
SharePoint/sp-dev-fx-webpartsCode samples and developer content targeted towards SharePoint Framework client-side web parts. http://aka.ms/spfxContribution guidelinesCreate from: master
Submit to: dev
SharePoint/sp-dev-list-formattingSharePoint List Formatting Samples https://sharepoint.github.io/sp-dev-list-formatting/Contribution guidelinesmaster
SharePoint/sp-dev-modernizationAll modernization tooling and guidance http://aka.ms/sppnp-modernizeThe modernization repositorydev
SharePoint/sp-provisioning-serviceCode for the provisioning service hosted at http://provisioning.sharepointpnp.comContributingdev
SharePoint/sp-usage-docsSharePoint Documentation on usage and feature patterns for site owners and citizen developersAdding contentmaster
Sharepoint/PnP-sites-coreOffice 365 Dev PnP Core component (.NET) targeted for increasing developer productivity with CSOM based solutions.Contribution guidancedev
pnp/office365-cliManage Microsoft Office 365 and SharePoint Framework projects on any platform https://aka.ms/o365cli- Contribution guidelines
- Adding a new command
- Submitting a PR
dev
pnp/pnpjsSharePoint Patterns and Practices Reusable Client-side Libraries https://pnp.github.io/pnpjsContribution guidedev

Thanks

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!

Photo credit

Image by StockSnap from Pixabay

Updates

  • 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.
Author

Independent consultant. Certified SCRUM Master. SharePoint, Office 365 and Dynamics 365 are his favourite toys.

How can I help?

This site uses Akismet to reduce spam. Learn how your comment data is processed.