mirror of https://github.com/kivy/kivy.git
Github: add CONTRIBUTING.md
This commit is contained in:
parent
f0a0aebee9
commit
a5d8ca9bb4
|
@ -0,0 +1,62 @@
|
|||
##[Contributing](http://kivy.org/docs/contribute.html)
|
||||
|
||||
There are many ways in which you can contribute to Kivy.
|
||||
Code patches are just one thing amongst others that you can submit to help the
|
||||
project. We also welcome feedback, bug reports, feature requests, documentation
|
||||
improvements, advertisement & advocating, testing, graphics contributions and
|
||||
many different things. Just talk to us if you want to help, and we will help you
|
||||
help us.
|
||||
|
||||
#Feedback
|
||||
--------
|
||||
|
||||
This is by far the easiest way to contribute something. If you're using
|
||||
Kivy for your own project, don't hesitate sharing. It doesn't have to be a
|
||||
high-class enterprise app, obviously. It's just incredibly motivating to
|
||||
know that people use the things you develop and what it enables them to
|
||||
do. If you have something that you would like to tell us, please don't
|
||||
hesitate. Screenshots and videos are also very welcome!
|
||||
We're also interested in the problems you had when getting started. Please
|
||||
feel encouraged to report any obstacles you encountered such as missing
|
||||
documentation, misleading directions or similar.
|
||||
We are perfectionists, so even if it's just a typo, let us know.
|
||||
|
||||
#[Reporting an Issue](http://kivy.org/docs/contribute.html#reporting-an-issue)
|
||||
|
||||
If you found anything wrong, a crash, segfault, missing documentation, invalid
|
||||
spelling, weird example, please take 2 minutes to report the issue. following
|
||||
the guide lines mentioned [here](http://kivy.org/docs/contribute.html#reporting-an-issue)
|
||||
|
||||
##[Code Contributions](http://kivy.org/docs/contribute.html#code-contributions)
|
||||
|
||||
Code contributions (patches, new features) are the most obvious way to help with
|
||||
the project's development. Since this is so common we ask you to follow our
|
||||
workflow to most efficiently work with us. Adhering to our workflow ensures that
|
||||
your contribution won't be forgotten or lost. Also, your name will always be
|
||||
associated with the change you made, which basically means eternal fame in our
|
||||
code history (you can opt-out if you don't want that).
|
||||
|
||||
|
||||
* [Coding style](http://kivy.org/docs/contribute.html#coding-style)
|
||||
* [Performances](http://kivy.org/docs/contribute.html#performances)
|
||||
* [Git & GitHub](http://kivy.org/docs/contribute.html#git-github)
|
||||
* [Code Workflow](http://kivy.org/docs/contribute.html#code-workflow)
|
||||
|
||||
##[Documentation Contributions](http://kivy.org/docs/contribute.html#documentation-contributions)
|
||||
|
||||
Documentation contributions generally follow the same workflow as code
|
||||
contributions, just a bit more lax. We don't ask you to go through all the
|
||||
hassle just to correct a single typo. For more complex contributions, please
|
||||
consider following the suggested workflow though.
|
||||
|
||||
|
||||
* #[Docstrings](http://kivy.org/docs/contribute.html#docstrings)
|
||||
|
||||
|
||||
#Unit tests contributions
|
||||
|
||||
For testing team, we have the document `contribute-unittest` that
|
||||
explains how Kivy unit test are working and how you can create your own. Use the
|
||||
same approach as the `Code Workflow` to [submit new tests](http://kivy.org/docs/contribute.html#unit-tests-contributions).
|
||||
|
||||
|
Loading…
Reference in New Issue