mirror of https://github.com/sipwise/jitsi.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
62 lines
3.1 KiB
62 lines
3.1 KiB
# How to contribute
|
|
We would love to have your help. Before you start working however, please read
|
|
and follow this short guide.
|
|
|
|
# Reporting Issues
|
|
Before you open an issue on GitHub, please discuss it on one of our
|
|
[mailing lists](https://jitsi.org/Development/MailingLists) and wait for a
|
|
confirmation from one of the committers. Once you have that confirmation,
|
|
please proceed to reporting the issue on Github, while providing as much
|
|
information as possible. Mention the version of Jitsi you are using, your
|
|
operating system and explain how the problem can be reproduced.
|
|
|
|
Please note that issues that are reported against a version older than the
|
|
current stable release will be closed without further investigation. If you
|
|
discover however that the issue also exists in an older version, this is
|
|
useful information. Even more useful is to know if it worked in a specific
|
|
version and stopped working in a subsequent version. This will help
|
|
developers pinpoint the issue. Also useful is to test the nightly build.
|
|
|
|
# Translation
|
|
Please go to our [translation website](http://translate.jitsi.org), which is a
|
|
[Pootle](http://pootle.translatehouse.org/) instance that allows for easy
|
|
online translation. Many languages are already there and waiting for completion.
|
|
|
|
If your preferred language is not yet created, please drop us an
|
|
[e-mail](mailto:dev@jitsi.org). Be aware though that completing a new language
|
|
will be quite some effort, so be sure you actually want to take on that
|
|
work and translate more than a few words.
|
|
|
|
Please do not create any pull requests for the resources_XX.properties files,
|
|
as they will be overwritten with what comes from
|
|
[Pootle](http://translate.jitsi.org). The only exception is if you find
|
|
mistakes in the language file for
|
|
[English](https://github.com/jitsi/jitsi/blob/master/resources/languages/resources.properties).
|
|
|
|
For more information, e.g. how to translate offline visit the
|
|
[How To Translate Jitsi](https://jitsi.org/Documentation/HowToTranslateSIPCommunicator)
|
|
on our website.
|
|
|
|
# Code contributions
|
|
Found a bug and know how to fix it? Great! Please read on.
|
|
|
|
## Contributor License Agreement
|
|
While Jitsi is released under the
|
|
[Apache](https://github.com/jitsi/jitsi/blob/master/LICENSE), the copyright
|
|
holder and principal creator is [Blue Jimp](http://www.bluejimp.com/). To
|
|
ensure that we can continue making Jitsi available under an open source license
|
|
and still pay our bills, we need you to sign our Apache-based contributor
|
|
license agreement as either a [corporation](https://jitsi.org/ccla) or an
|
|
[individual](https://jitsi.org/icla). If you cannot accept the terms laid out
|
|
in the agreement, unfortunately, we cannot accept your contribution.
|
|
|
|
## Coding Rules
|
|
- Please read and follow the [code conventions](https://jitsi.org/Documentation/CodeConvention),
|
|
especially the limit on 80 characters per line.
|
|
- Do not reformat existing code.
|
|
|
|
## Creating Pull Requests
|
|
- Perform **one** logical change per pull request.
|
|
- Maintain a clean list of commits, squash them if necessary.
|
|
- Rebase your topic branch on top of the master branch before creating the pull request.
|