diff options
author | Fla <flaburgan@geexxx.fr> | 2017-06-30 17:27:29 +0300 |
---|---|---|
committer | flaburgan <flaburgan@geexxx.fr> | 2017-07-12 17:14:58 +0300 |
commit | f94fa956532d92a47fd781a9984ce2b744365e2c (patch) | |
tree | dc0120b5e4c7aa32b202dcb01f0a93635c093619 /CONTRIBUTING.md | |
parent | d62d79bc293c89c6439ce4ec2414a17d5dc5b11e (diff) |
Add a Contributing file
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r-- | CONTRIBUTING.md | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 000000000..797e62775 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,42 @@ +# Contributing to diaspora\* + +First of all: thank you very much for helping us out! + +## Things you need to know before contributing + +If you want to get in touch with other diaspora\* developers, [check our wiki][how-we-communicate] for information on how we communicate. Feel free to ask if you have any questions! + +Everyone interacting with our code, issue trackers, chat rooms, mailing lists, the wiki, and the discourse forum is expected to follow the [diaspora\* code of conduct][code-of-conduct]. + +## Report a security issue + +Found a security issue? Please disclose it responsibly. We have a team of developers listening to [security@diasporafoundation.org][sec-mail]. The PGP fingerprint is [AB0D AB02 0FC5 D398 03AB 3CE1 6F70 243F 27AD 886A][pgp]. + +## Contributing to translations + +We use [WebTranslateIt][webtranslateit] to manage translations of the app interface. Please read [our wiki page][translation-wiki] to find out more about this. If your language is featured on WebTranslateIt, please do **not** open a pull request to update translations. If it is not already featured on WebTranslateIt, please read the wiki article above to find out how to proceed. + +## Contributing to the code + +**Before opening a pull request** please read [how to contribute][contribute]. Doing things the right way from the start will save us time and mean that your contribution can be integrated quicker! +- Follow our [git workflow][git-workflow] method. In particular, *do not* open a pull request from the `master` or the `develop` branch. +- Follow our [styleguide][styleguide] and run pronto, our syntax analyzer, **locally before opening a pull request**. See [our wiki][pronto] for information on how to do this. +- [Write tests][testing-workflow]. +- Use meaningful commit-messages and split larger tasks, e.g. refactoring, into separate commits. This makes the review process much easier. + +## Other ways to contribute + +You don’t know code? No worries, there are plenty other ways to help the diaspora* project! Please find out how you can help [on our wiki][other-ways]. + +[code-of-conduct]: https://github.com/diaspora/diaspora/blob/develop/CODE_OF_CONDUCT.md +[how-we-communicate]: https://wiki.diasporafoundation.org/How_we_communicate +[pgp]: https://pgp.mit.edu/pks/lookup?op=get&search=0x6F70243F27AD886A +[sec-mail]: mailto:security@diasporafoundation.org +[webtranslateit]: https://webtranslateit.com/en/projects/3020-Diaspora +[translation-wiki]: https://wiki.diasporafoundation.org/Contribute_translations +[contribute]: https://wiki.diasporafoundation.org/Getting_started_with_contributing +[git-workflow]: https://wiki.diasporafoundation.org/Git_Workflow +[styleguide]: https://wiki.diasporafoundation.org/Styleguide +[pronto]: https://wiki.diasporafoundation.org/Styleguide#Automatic_local_review +[testing-workflow]: https://wiki.diasporafoundation.org/Testing_Workflow +[other-ways]: https://wiki.diasporafoundation.org/Other_ways_to_contribute |