Skip to content

Commit 726046b

Browse files
committed
update contributions
1 parent 7189368 commit 726046b

File tree

2 files changed

+56
-0
lines changed

2 files changed

+56
-0
lines changed

CONTRIBUTING.md

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Contributing to rocketsled
2+
We love your input! We want to make contributing to rocketsled as easy and transparent as possible, whether it's:
3+
* Reporting a bug
4+
* Discussing the current state of the code
5+
* Submitting a fix
6+
* Proposing or implementing new features
7+
* Becoming a maintainer
8+
9+
## Reporting bugs, getting help, and discussion
10+
At any time, feel free to start a thread on our [Google Group](https://groups.google.com/forum/#!forum/fireworkflows).
11+
12+
If you are making a bug report, incorporate as many elements of the following as possible to ensure a timely response and avoid the need for followups:
13+
* A quick summary and/or background
14+
* Steps to reproduce - be specific! **Provide sample code.**
15+
* What you expected would happen, compared to what actually happens
16+
* The full stack trace of any errors you encounter
17+
* Notes (possibly including why you think this might be happening, or steps you tried that didn't work)
18+
19+
We love thorough bug reports as this means the development team can make quick and meaningful fixes. When we confirm your bug report, we'll move it to the GitHub issues where its progress can be further tracked.
20+
21+
## Contributing code modifications or additions through Github
22+
We use github to host code, to track issues and feature requests, as well as accept pull requests.
23+
24+
Pull requests are the best way to propose changes to the codebase. Follow the [Github flow](https://www.atlassian.com/git/tutorials/comparing-workflows/forking-workflow) for more information on this procedure.
25+
26+
The basic procedure for making a PR is:
27+
* Fork the repo and create your branch from master.
28+
* Commit your improvements to your branch and push to your Github fork (repo).
29+
* When you're finished, go to your fork and make a Pull Request. It will automatically update if you need to make further changes.
30+
31+
### How to Make a **Great** Pull Request
32+
We have a few tips for writing good PRs that are accepted into the main repo:
33+
34+
* Use the Google Code style for all of your code. Find an example [here.](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html)
35+
* Your code should have (4) spaces instead of tabs.
36+
* If needed, update the documentation.
37+
* **Write tests** for new features! Good tests are 100%, absolutely necessary for good code. We use the python `unittest` framework -- see some of the other tests in this repo for examples, or review the [Hitchhiker's guide to python](https://docs.python-guide.org/writing/tests/) for some good resources on writing good tests.
38+
* Understand your contributions will fall under the same license as this repo.
39+
40+
When you submit your PR, our CI service will automatically run your tests.
41+
We welcome good discussion on the best ways to write your code, and the comments on your PR are an excellent area for discussion.
42+
43+
#### References
44+
This document was adapted from the open-source contribution guidelines for Facebook's Draft, as well as briandk's [contribution template](https://gist.github.com/briandk/3d2e8b3ec8daf5a27a62).

docs_rst/index.rst

+12
Original file line numberDiff line numberDiff line change
@@ -240,6 +240,18 @@ exhaustively documents the possible arguments to ``OptTask`` and provides at lea
240240
one example of each. If working through the tutorials did not answer your
241241
question, you'll most likely find your answer here.
242242

243+
Contributions and Support
244+
-------------------------
245+
Want to see something added or changed? Here's a few ways you can!
246+
247+
* Help us improve the documentation. Tell us where you got 'stuck' and improve the install process for everyone.
248+
* Let us know about areas of the code that are difficult to understand or use.
249+
* Contribute code! Fork our `Github repo <https://github.com/hackingmaterials/rocketsled>`_ and make a pull request.
250+
251+
Submit all questions and contact to the `Google group <https://groups.google.com/forum/#!forum/fireworkflows>`_
252+
253+
A comprehensive guide to contributions can be found `here. <https://github.com/hackingmaterials/rocketsled/blob/master/CONTRIBUTING.md>`_
254+
243255
Documentation
244256
-------------
245257

0 commit comments

Comments
 (0)