-
Notifications
You must be signed in to change notification settings - Fork 2.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
added CONTRIBUTING.md (adjusted from EventBus)
- Loading branch information
1 parent
cd5d6f2
commit 9630848
Showing
1 changed file
with
45 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,45 @@ | ||
Before you create an Issue... | ||
============================= | ||
|
||
There are better Places for Support | ||
----------------------------------- | ||
We want your question to be answered, so it is important that you ask at the right place. Be aware that an issue tracker is not the best place to ask for support. An issue tracker is used to track issues (bugs or feature requests). | ||
Instead, please use [stackoverflow.com](http://stackoverflow.com/questions/tagged/greendao?sort=frequent) and use the tag [greendao](http://stackoverflow.com/tags/greendao/info) for your question. | ||
|
||
If you want professional support, check http://greenrobot.org/contact-support/. | ||
|
||
Examples for support questions that are more likely to be answered on StackOverflow: | ||
|
||
* Asking how something works | ||
* Asking how to use greenDAO in a specific scenario | ||
* Your app crashes/misbehaves and you are not sure why | ||
|
||
The perfect Issue Report | ||
------------------------ | ||
A couple of simple steps can save time for everyone. | ||
|
||
Check before reporting: | ||
|
||
* It's not a support inquiry | ||
* You have read the docs | ||
* You searched the web and stackoverflow | ||
* You searched existing issues to avoid duplicates | ||
|
||
Reporting bugs: | ||
|
||
* Please investigate if is the bug is really caused by the library. Isolate the issue: what's the minimal code to reproduce the bug? | ||
* Bonus steps to gain extra karma points: once you isolated and identified the issue, you can prepare an push request. Submit an unit test causing the bug, and ideally a fix for the bug. | ||
|
||
Requesting features: | ||
|
||
* Ask yourself: is the feature useful for a majority users? One of our major goals is to keep the API simple and concise. We do not want to cover all possible use cases, but those that make 80% of users happy. | ||
|
||
A Note on Pull Requests | ||
======================= | ||
Pull requests (and issues) may queue up up a bit. Usually, pull requests and issues are checked when new releases are planned. | ||
|
||
For bigger pull requests, it's a good idea to check with the maintainer upfront about the idea and the implementation outline. | ||
|
||
Thanks for reading! | ||
=================== | ||
It's your contributions and feedback that makes maintaining this library fun. |