Intro to OSS Contribution for Jupyter Studio Day

instructions.md

Step 1: pick a repo

Read the project's contributor guidelines

Step 2: pick a task

No code

• copyedit documentation
• localization
• accessibility
  • alt text (example alt text PR)
  • tool testing: screen reader, keyboard nav

No commitment

• test/validate issues, PRs, and examples
  • esp. old issues - can they be closed?

No fear

• "good first issue"s
  • first check: is anyone actively working on it?

Step 3: environment setup

• If you find a problem with the repo's setup documentation, fix it or raise an issue!
• Be sure to build/run/test main before making changes

Step 4: do the task + validate

Stuck? Ask questions on the issue, at a community call, on discourse.

Step 5: open a PR

Step 6: follow through

It is very typical for any PR, especially from a first time contributor, to need a few rounds of feedback+revision before merging.

Step 7: celebrate your new passion for Jupyter contribution by showing up to a subproject meeting

Jupyter Community Calendar

resources.md

this gist: https://tinyurl.com/studioday101

Creating an account on GitHub

Pull request basics