-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #20 from ocefpaf/PR_template
add PR template
- Loading branch information
Showing
2 changed files
with
63 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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/). |