blob: 76e7450c261bfac5db66a61dd08ea92dff20e0d2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
Contributing
============
Thank you for your interest in contributing to Soledad!
Filing bug reports
------------------
Bug reports are very welcome. Please file them on the `0xacab issue tracker
<https://0xacab.org/leap/soledad/issues>`_. Please include an extensive
description of the error, the steps to reproduce it, the version of Soledad
used and the provider used (if applicable).
Patches
-------
All patches to Soledad should be submitted in the form of pull requests to the
`main Soledad repository <https://0xacab.org/leap/soledad>`_. These pull
requests should satisfy the following properties:
* The pull request should focus on one particular improvement to Soledad.
Create different pull requests for unrelated features or bugfixes.
* Code should follow `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_,
especially in the "do what code around you does" sense.
* Pull requests that introduce code must test all new behavior they introduce
as well as for previously untested or poorly tested behavior that they touch.
* Pull requests are not allowed to break existing tests. We will consider pull
requests that are breaking the CI as work in progress.
* When introducing new functionality, please remember to write documentation.
* Please sign all of your commits. If you are merging code from other
contributors, you should sign their commits.
Review
~~~~~~
Pull requests must be reviewed before merging. The final responsibility for the
reviewing of merged code lies with the person merging it. Exceptions to this
rule are modifications to documentation, packaging, or tests when the need of
agility of merging without review has little or no impact on the security and
functionality of working code.
Getting help
~~~~~~~~~~~~
If you need help you can reach us through one of the following means:
* IRC: ``#leap`` at ``irc.freenode.org``.
* Mailing list: `leap-discuss@lists.riseup.net <https://lists.riseup.net/www/info/leap-discuss>`_
|