Skip to content

Commit

Permalink
Merge pull request #20 from ocefpaf/PR_template
Browse files Browse the repository at this point in the history
add PR template
  • Loading branch information
ocefpaf authored Feb 27, 2023
2 parents 33e430c + ee06cff commit 3aba3ee
Show file tree
Hide file tree
Showing 2 changed files with 63 additions and 0 deletions.
23 changes: 23 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
<!--
Thank you for contributing with a pull request!
Please ensure you have taken a look at the contribution guidelines before proceeding:
https://github.com/ioos/ioos-python-package-skeleton/blob/main/CONTRIBUTING.md
-->

#### Description Of Changes in the Pull Request

<!--
Feel free to remove the items are not relevant to your change in the check-list below.
Try to use keywords (e.g., Fixes, Closes) to create link to the issues or pull
requests you resolved, so that they will automatically be closed when your pull
request is merged. See https://github.com/blog/1506-closing-issues-via-pull-requests
-->

#### Checklist

- [ ] I read the [CONTRIBUTING.md](https://github.com/ioos/ioos-python-package-skeleton/blob/main/CONTRIBUTING.md) guide
- [ ] Closes #xxxx
- [ ] Added Tests
- [ ] Added Documented of the changes/features
40 changes: 40 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Contributors Guide

Are you interested in helping out?
Have a few minutes to tackle an issue?
In this guide we will get you setup into contributing to our project!

## Setting up your development environment

We recommend using the [conda](https://conda.io/docs/) package manager for your environments.
Our recommended setup for contributing is:

1. Install [miniconda](https://docs.conda.io/en/latest/miniconda.html) on your system.
You may have to restart your prompt for the remaining steps to work.

2. Now, with a local clone, of your fork\* you can create a development environment with:

```shell
conda create --name MYENV python=3 --file requirements.txt --file requirements-dev.txt
```

3. The changes should be made via GitHub pull requests\* against ``main``.


## More Questions?

If you're stuck somewhere or are interested in being a part of the community in
other ways, feel free to contact us!

## Further Reading

There are a ton of great resources out there on contributing to open source and on the
importance of writing tested and maintainable software.

* [How to Contribute to Open Source Guide](https://opensource.guide/how-to-contribute/)
* [Zen of Scientific Software Maintenance](https://jrleeman.github.io/ScientificSoftwareMaintenance/)

**Working on your first Pull Request?** You can learn how from this video series
[How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github),
Aaron Meurer's [tutorial on the git workflow](https://www.asmeurer.com/git-workflow/), or the
guide [“How to Contribute to Open Source"](https://opensource.guide/how-to-contribute/).

0 comments on commit 3aba3ee

Please sign in to comment.