2016-09-27 11:43:43 +00:00
|
|
|
NewPipe contribution guidelines
|
|
|
|
===============================
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2017-08-02 21:34:46 +00:00
|
|
|
PLEASE READ THESE GUIDELINES CAREFULLY BEFORE ANY CONTRIBUTION!
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2016-09-27 12:14:59 +00:00
|
|
|
## Crash reporting
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2018-12-01 08:21:57 +00:00
|
|
|
Do not report crashes in the GitHub issue tracker. NewPipe has an automated crash report system that will ask you to
|
|
|
|
send a report via e-mail when a crash occurs. This contains all the data we need for debugging, and allows you to even
|
|
|
|
add a comment to it. You'll see exactly what is sent, the system is 100% transparent.
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2017-08-02 21:34:46 +00:00
|
|
|
## Issue reporting/feature requests
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2018-12-01 08:21:57 +00:00
|
|
|
* Search the [existing issues](https://github.com/TeamNewPipe/NewPipe/issues) first to make sure your issue/feature
|
|
|
|
hasn't been reported/requested before
|
2017-08-02 21:34:46 +00:00
|
|
|
* Check whether your issue/feature is already fixed/implemented
|
2018-03-28 07:58:09 +00:00
|
|
|
* Check if the issue still exists in the latest release/beta version
|
2017-08-02 21:34:46 +00:00
|
|
|
* If you are an Android/Java developer, you are always welcome to fix/implement an issue/a feature yourself. PRs welcome!
|
|
|
|
* We use English for development. Issues in other languages will be closed and ignored.
|
2017-09-19 17:21:20 +00:00
|
|
|
* Please only add *one* issue at a time. Do not put multiple issues into one thread.
|
2018-06-05 09:03:48 +00:00
|
|
|
* When reporting a bug please give us a context, and a description how to reproduce it.
|
2019-01-11 15:41:16 +00:00
|
|
|
* Issues that only contain a generated bug report, but no description might be closed.
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2017-08-02 21:34:46 +00:00
|
|
|
## Bug Fixing
|
2018-12-01 08:21:57 +00:00
|
|
|
* If you want to help NewPipe to become free of bugs (this is our utopic goal for NewPipe), you can send us an email to
|
|
|
|
tnp@newpipe.schabi.org to let me know that you intend to help. We'll send you further instructions. You may, on request,
|
|
|
|
register at our [Sentry](https://sentry.schabi.org) instance (see section "Crash reporting" for more information.
|
2017-02-11 23:16:41 +00:00
|
|
|
|
2016-01-05 19:56:40 +00:00
|
|
|
## Translation
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2018-12-01 08:21:57 +00:00
|
|
|
* NewPipe can be translated via [Weblate](https://hosted.weblate.org/projects/newpipe/strings/). You can log in there
|
|
|
|
with your GitHub account.
|
2015-12-22 15:14:56 +00:00
|
|
|
|
2016-09-27 11:43:43 +00:00
|
|
|
## Code contribution
|
2015-12-23 08:31:11 +00:00
|
|
|
|
2017-08-02 21:34:46 +00:00
|
|
|
* Stick to NewPipe's style conventions (well, just look the other code and then do it the same way :))
|
2018-12-01 08:21:57 +00:00
|
|
|
* Do not bring non-free software (e.g., binary blobs) into the project. Also, make sure you do not introduce Google
|
|
|
|
libraries.
|
2017-08-02 21:34:46 +00:00
|
|
|
* Stick to [F-Droid contribution guidelines](https://f-droid.org/wiki/page/Inclusion_Policy)
|
2018-12-01 08:21:57 +00:00
|
|
|
* Make changes on a separate branch, not on the master branch. This is commonly known as *feature branch workflow*. You
|
|
|
|
may then send your changes as a pull request on GitHub. Patches to the email address mentioned in this document might
|
|
|
|
not be considered, GitHub is the primary platform. (This only affects you if you are a member of TeamNewPipe)
|
|
|
|
* When submitting changes, you confirm that your code is licensed under the terms of the
|
|
|
|
[GNU General Public License v3](https://www.gnu.org/licenses/gpl-3.0.html).
|
|
|
|
* Please test (compile and run) your code before you submit changes! Ideally, provide test feedback in the PR
|
|
|
|
description. Untested code will **not** be merged!
|
2017-08-02 21:34:46 +00:00
|
|
|
* Try to figure out yourself why builds on our CI fail.
|
2018-12-01 08:21:57 +00:00
|
|
|
* Make sure your PR is up-to-date with the rest of the code. Often, a simple click on "Update branch" will do the job,
|
|
|
|
but if not, you are asked to merge the master branch manually and resolve the problems on your own. That will make the
|
|
|
|
maintainers' jobs way easier.
|
|
|
|
* Please show intention to maintain your features and code after you contributed it. Unmaintained code is a hassle for
|
|
|
|
the core developers, and just adds work. If you do not intend to maintain features you contributed, please think again
|
|
|
|
about submission, or clearly state that in the description of your PR.
|
2017-08-02 21:34:46 +00:00
|
|
|
* Respond yourselves if someone requests changes or otherwise raises issues about your PRs.
|
2017-10-23 13:16:34 +00:00
|
|
|
* Check if your contributions align with the [fdroid inclusion guidelines](https://f-droid.org/en/docs/Inclusion_Policy/).
|
|
|
|
* Check if your submission can be build with the current fdroid build server setup.
|
2018-12-01 08:21:57 +00:00
|
|
|
* Send PR that only cover one specific issue/solution/bug. Do not send PRs that are huge and consists of multiple
|
|
|
|
independent solutions.
|
2015-12-23 08:31:11 +00:00
|
|
|
|
2015-12-22 15:14:56 +00:00
|
|
|
## Communication
|
|
|
|
|
2017-02-11 21:26:00 +00:00
|
|
|
* WE DO NOW HAVE A MAILING LIST: [newpipe@list.schabi.org](https://list.schabi.org/cgi-bin/mailman/listinfo/newpipe).
|
2018-12-01 08:21:57 +00:00
|
|
|
* There is an IRC channel on Freenode which is regularly visited by the core team and other developers:
|
|
|
|
[#newpipe](irc:irc.freenode.net/newpipe). [Click here for Webchat](https://webchat.freenode.net/?channels=newpipe)!
|
|
|
|
* If you want to get in touch with the core team or one of our other contributors you can send an email to
|
|
|
|
tnp(at)schabi.org. Please do not send issue reports, they will be ignored and remain unanswered! Use the GitHub issue
|
|
|
|
tracker described above!
|
2017-08-02 21:34:46 +00:00
|
|
|
* Feel free to post suggestions, changes, ideas etc. on GitHub, IRC or the mailing list!
|