Skip to content

Latest commit

 

History

History
37 lines (17 loc) · 2.08 KB

CONTRIBUTING.md

File metadata and controls

37 lines (17 loc) · 2.08 KB

Contribute to the guide

Contribute text to the chapters

Contribute directly to chapters (01-Intro.Rmd). Either through the GitHub website and direct edits to the R markdown files prefixed with chapter numbers (eg. 01-intro.Rmd). You can write both markdown or R, and even python code. The site is built using the R package bookdown through GitHub Actions, so all you need to do is edit the R markdown file and GitHub will take care of the rest.

If you are a member of the IOOS GitHub biodata team you can edit the files directly on GitHub, or through a fork and then pull-request if you're an external collaborator. Once the pull-request is approved and merged, the documentation site will update to reflect your changes (takes about 10 minutes for the site to update after PR is merged).

‼️ Don't forget to add your name and orcid to the citation file!

Contribute example applications

Document your example application in an R markdown (.Rmd) or markdown (.md) file in the appropriate directory under datasets/. Submit a ticket or update 02-applications.Rmd with a pointer to your application example file.

Note: The largest header in your markdown file should be a second level header (ie. ##). This is a requirement for how the book gets built, the largest header (#) are the chapter identifiers.

Issues

Most issues have tags. Look for specific ones where you can help, or post a new issue!

Tags

Questions

The easiest way to help out is to answer questions tagged in Issues. You won’t know the answer to everything, but that’s ok! Even just the acknowledgement that someone cares enough to try can be tremendously encouraging.

Help wanted

Issues tagged with Help Wanted... is where we show issues we need help with!

Good First Issue

A great issues to start with if you've never worked on GitHub issues like this before!