Skip to content

Commit 3aba3ee

Browse files
authored
Merge pull request #20 from ocefpaf/PR_template
add PR template
2 parents 33e430c + ee06cff commit 3aba3ee

File tree

2 files changed

+63
-0
lines changed

2 files changed

+63
-0
lines changed

.github/pull_request_template.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
<!--
2+
Thank you for contributing with a pull request!
3+
Please ensure you have taken a look at the contribution guidelines before proceeding:
4+
5+
https://github.com/ioos/ioos-python-package-skeleton/blob/main/CONTRIBUTING.md
6+
-->
7+
8+
#### Description Of Changes in the Pull Request
9+
10+
<!--
11+
Feel free to remove the items are not relevant to your change in the check-list below.
12+
13+
Try to use keywords (e.g., Fixes, Closes) to create link to the issues or pull
14+
requests you resolved, so that they will automatically be closed when your pull
15+
request is merged. See https://github.com/blog/1506-closing-issues-via-pull-requests
16+
-->
17+
18+
#### Checklist
19+
20+
- [ ] I read the [CONTRIBUTING.md](https://github.com/ioos/ioos-python-package-skeleton/blob/main/CONTRIBUTING.md) guide
21+
- [ ] Closes #xxxx
22+
- [ ] Added Tests
23+
- [ ] Added Documented of the changes/features

CONTRIBUTING.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Contributors Guide
2+
3+
Are you interested in helping out?
4+
Have a few minutes to tackle an issue?
5+
In this guide we will get you setup into contributing to our project!
6+
7+
## Setting up your development environment
8+
9+
We recommend using the [conda](https://conda.io/docs/) package manager for your environments.
10+
Our recommended setup for contributing is:
11+
12+
1. Install [miniconda](https://docs.conda.io/en/latest/miniconda.html) on your system.
13+
You may have to restart your prompt for the remaining steps to work.
14+
15+
2. Now, with a local clone, of your fork\* you can create a development environment with:
16+
17+
```shell
18+
conda create --name MYENV python=3 --file requirements.txt --file requirements-dev.txt
19+
```
20+
21+
3. The changes should be made via GitHub pull requests\* against ``main``.
22+
23+
24+
## More Questions?
25+
26+
If you're stuck somewhere or are interested in being a part of the community in
27+
other ways, feel free to contact us!
28+
29+
## Further Reading
30+
31+
There are a ton of great resources out there on contributing to open source and on the
32+
importance of writing tested and maintainable software.
33+
34+
* [How to Contribute to Open Source Guide](https://opensource.guide/how-to-contribute/)
35+
* [Zen of Scientific Software Maintenance](https://jrleeman.github.io/ScientificSoftwareMaintenance/)
36+
37+
**Working on your first Pull Request?** You can learn how from this video series
38+
[How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github),
39+
Aaron Meurer's [tutorial on the git workflow](https://www.asmeurer.com/git-workflow/), or the
40+
guide [“How to Contribute to Open Source"](https://opensource.guide/how-to-contribute/).

0 commit comments

Comments
 (0)