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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
Contributing to Mu
------------------
Hey! Many thanks for wanting to improve Mu.
Contributions are welcome without prejudice from *anyone* irrespective of
age, gender, religion, race or sexuality. If you're thinking, "but they don't
mean me", *then we especially mean YOU*. Good quality code and engagement
with respect, humour and intelligence wins every time.
* If you're from a background which isn't well-represented in most geeky
groups, get involved - *we want to help you make a difference*.
* If you're from a background which *is* well-represented in most geeky
groups, get involved - *we want your help making a difference*.
* If you're worried about not being technical enough, get involved - *your
fresh perspective will be invaluable*.
* If you think you're an imposter, get involved.
* If your day job isn't code, get involved.
* This isn't a group of experts, just people. Get involved!
* We are interested in educational, social and technical problems. If you are
too, get involved.
* This is a new community. *No-one knows what they are doing*, so, get involved.
We expect contributors to follow our `code_of_conduct <https://mu.readthedocs.io/en/latest/code_of_conduct.html>`_.
Check out our
`developer setup <https://mu.readthedocs.io/en/latest/setup.html>`_
documentation for instructions to configure a working development environment
for Mu.
Feedback may be given for contributions and, where necessary, changes will
be politely requested and discussed with the originating author. Respectful
yet robust argument is most welcome.
.. warning::
**Contributions are subject to the following caveats**: the contribution
was created by the contributor who, by submitting the contribution, is
confirming that they have the authority to submit the contribution and
place it under the license as defined in the LICENSE file found within
this repository (see :doc:`license`). If this is a significant contribution
the contributor should add themselves to the AUTHORS file found in the
root of Mu's repository, otherwise they agree, for the sake of convenience,
that copyright passes exclusively to Nicholas H.Tollervey on behalf of the
Mu project.
Checklist
+++++++++
* If your contribution includes non-obvious technical decision making please
make sure you document this in the
`design decisions <https://mu.readthedocs.io/en/latest/design.html>`_
section.
* Your code should be commented in *plain English* (British spelling).
* If your contribution is for a major block of work and you've not done so
already, add yourself to the AUTHORS file following the convention found
therein.
* We have 100% test coverage - include tests to maintain this!
* **Before submitting code ensure coding standards and test coverage by running**::
make check
* If in doubt, ask a question. The only stupid question is the one that's never asked.
* Most importantly, **Have fun!** :-)
|
