Contributing

There are dozens of ways to contribute in Weblate. We welcome any help, be it coding help, graphics design, documentation or sponsorship.

Code and development

Weblate is being developed on GitHub. You are welcome to fork the code and open pull requests. Patches in any other form are welcome as well.

См.также

Check out Internals to see how Weblate looks from inside.

Coding standard

The code should follow PEP-8 coding guidelines.

It is good idea to check your contributions using pep8, pylint and pyflages. You can execute all checks by script ci/run-lint.

Developer’s Certificate of Origin

If you would like to make a contribution to the Weblate project, please certify to the following:

Weblate Developer’s Certificate of Origin. Version 1.0

By making a contribution to this project, I certify that:

  1. The contribution was created in whole or in part by me and I have the right to submit it under the license of «GNU General Public License or any later version» («GPLv3-or-later»); or

  2. The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under GPLv3-or-later; or

  3. The contribution was provided directly to me by some other person who certified (a) or (b) and I have not modified it.

  4. I understand and agree that this project and the contribution are public and that a record of the contribution (including all metadata and personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with Weblate’s policies and the requirements of the GPLv2-or-later where they are relevant.

  5. I am granting this work to this project under the terms of the GPLv3-or-later.

    https://www.gnu.org/licenses/gpl-3.0.html

And please confirm your certification to the above by adding the following line to your patch:

Signed-off-by: Jane Developer <jane@example.org>

using your real name (sorry, no pseudonyms or anonymous contributions).

If you are a developer who is authorized to contribute to Weblate on behalf of your employer, then please use your corporate email address in the Signed-off-by tag. If not, then please use a personal email address.

Testsuite

We do write testsuite for our code, so please add testcases for any new functionality and verify that it works. You can see current test results on Travis and coverage on Codecov.

To run testsuite locally, use:

DJANGO_SETTINGS_MODULE=weblate.settings_test ./manage.py test

You can also specify individual tests to run:

DJANGO_SETTINGS_MODULE=weblate.settings_test ./manage.py test weblate.gitexport

См.также

See Testing in Django for more info on running and writing tests for Django.

Reporting issues

Our issue tracker is hosted at GitHub:

Feel welcome to report any issues with or suggest improvement of Weblate there. In case you have found a security issue in Weblate, please consult the «Security issues» section below.

Security issues

In order to give the community time to respond and upgrade we strongly urge you report all security issues privately. We’re currently using HackerOne to handle security issues, so you are welcome to report issues directly at HackerOne.

Alternatively you can report them to security@weblate.org, which ends up on HackerOne as well.

If you don’t want to use HackerOne, for whatever reason, you can send the report by email to michal@cihar.com. You can choose to encrypt it using his PGP key 3CB 1DF1 EF12 CF2A C0EE 5A32 9C27 B313 42B7 511D.

Примечание

We’re heavily depending on third party components for many things. In case you find a vulnerability which is affecting those components in general, please report it directly to them.

Some of these are:

Starting with our codebase

If you are looking for some bugs which should be good for starting with our codebase, you can find them labelled with :guilabel:` good first issue ` tag:

If you have Docker and docker-compose installed you can spin up the development environment simply by running:

./rundev.sh

Earning money by coding

We’re using Bountysource to fund our development, you can participate as well by solving issues with bounties on them:

https://github.com/WeblateOrg/weblate/labels/bounty

Translating

Weblate is being translated using Weblate itself, feel free to take part in the effort of making Weblate available in as many human languages as possible.

Funding Weblate development

You can fund further Weblate development on Bountysource. Funds collected there are used to fund free hosting for libre software projects and further development of Weblate. Please check the Bountysource page for details, such as funding goals and rewards you can get for funding.

Backers who have funded Weblate

List of Weblate supporters from Bountysource:

  • Yashiro Ccs
  • Cheng-Chia Tseng
  • Timon Reinhard
  • Cassidy James
  • Loic Dachary

Releasing Weblate

Release checklist:

  1. Make sure screenshots are up to date make -C docs update-screenshots
  2. Create a release ./scripts/create-release --tag
  3. Push tags to GitHub
  4. Update Docker image
  5. Close GitHub milestone
  6. Enable building version docs on Read the Docs
  7. Once the Docker image is tested, add a tag and push it