This repository has been archived by the owner on Dec 26, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
First draft of CONTRIBUTING guidelines (#34)
Resolves #22 * First draft of CONTRIBUTING guidelines * Link to contributing guidelines in README
- Loading branch information
Showing
2 changed files
with
46 additions
and
2 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,45 @@ | ||
## Contributing to Nourish.Party | ||
There are four main ways to contribute to Nourish.Party, and we are grateful for each and every contribution you choose to make. | ||
|
||
1. Promoting and improving adoption of Nourish.Party. | ||
1. Setting up or supporting a Nourish.Party instance. | ||
1. Extending the Nourish.Party ecosystem by building add-ons and extensions. | ||
1. Improving the core Nourish.Party application. | ||
|
||
|
||
To attempt a shared level of clarity the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt). | ||
|
||
### Promoting and Improving Adoption of Nourish.Party | ||
At this time, we are unclear on how to best promote adoption of Nourish.Party. If you happen to have expertise in marketing open-source products, we'd love to hear from you! Drop us a line at [[email protected]](mailto: [email protected]). | ||
|
||
### Setting up or Supporting a Nourish.Party instance | ||
We intend to make setting up a Nourish.Party instance as painless as possible, however we are planning to do that by prioritizing a Heroku button type experience. If you have experience making one-click installs of applications on hosting control panels or work with cloud service providers, we'd love your help! Drop a line to [[email protected]](mailto: [email protected]). | ||
|
||
### Extending the Nourish.Party ecosystem | ||
Our goal is for Nourish.Party to plug directly into your existing distribution channels, from amazon stores to etsy to Discord to Slack. As you can imagine, that's quite a feat! If you'd like to get involved building an extension, we'd love for you to start building on our OAuth, REST, GraphQL, and Webhook APIs. (Which aren't designed, docuemnted, or built yet... BUT SOON). | ||
|
||
### Improving the core Nourish.Party application | ||
Right now, there are four ways to contribute | ||
|
||
#### Providing Feedback to Nourish.Party Maintainers | ||
Nourish.Party is open-source, community built software. While we intend to place the user first, we sometimes fail to do so. One of the most valuable thing you can do to improve the Nourish.Party is to provide us with specific, actionable and detailed feedback. We're especially interested in hearing about: | ||
|
||
* How Nourish.Party is (or is not!) helping you achieve your goals for financial independence as an independent creative or a small group of creatives. | ||
* Wins or bugs you experienced using Nourish as a supporter. | ||
* Gaps in our documentation, either as a Nourish.Party site host, add-on developer, or contributor to the core nourish.party platform. | ||
* Vulnerabilities or risks. Please report these to [[email protected]](mailto: [email protected]). | ||
|
||
To provide feedback you *should* either create a ticket in our [issue tracker](https://github.com/wecohere/nourish.party/issues) or email [[email protected]](mailto: [email protected]). | ||
|
||
#### Contributing Patches | ||
Patches are very much welcome! From documentation improvements to bug fixes to features, we're grateful for any contributions you send our way. We strongly err on the side of merging patches, so long as the patch meets the following requirements: | ||
|
||
* The patch *must* pass the automated tests, as that ensures there are not unexpected regressions in behavior. | ||
* The patch *should* pass our automated style-guide checker, as that helps make the application easier to work with for all contributors. | ||
* The patch *should* include inline documentation for non-private methods, as that helps new contributors learn why a given class or method exists. | ||
* The patch *should* rely on i18n for user-facing content, as this makes customization and collaboration with non-programmer copy-editors much easier. | ||
* The patch *should* be small, as that makes it easier to review and merge quickly. | ||
* The patch *must not* reduce test coverage significantly, as that helps future contributors not break your amazing patch. | ||
* The patch *must* be approved by a core maintainer, as we are the ones on the hook for maintaining it far into the future. | ||
|
||
We strive to provide both automated feedback and human-written specific, actionable and kind feedback to contributors. That said, we are an all volunteer organization, which means we may not be as responsive or available as you would like. We ask that you are patient with us. |
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