From 47aa7979b2d5b9c3ae7b61958eec7a68ea192e7b Mon Sep 17 00:00:00 2001 From: john gravois Date: Tue, 17 Jan 2017 12:23:54 -0800 Subject: [PATCH] small CONTRIBUTING copyedits Closes #6067 // FREEBIE --- .github/PULL_REQUEST_TEMPLATE.md | 2 +- CONTRIBUTING.md | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 618508455a..23feaa36da 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -2,7 +2,7 @@ ### First time contributor checklist - [ ] I have read [how to contribute](https://github.com/WhisperSystems/Signal-Android/blob/master/CONTRIBUTING.md) to this project -- [ ] I have signed the [Contributor Licence Agreement](https://whispersystems.org/cla/) +- [ ] I have signed the [Contributor License Agreement](https://whispersystems.org/cla/) ### Contributor checklist diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bef49e5185..c9704a22e3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Contributing to Signal Android -Thank you for deciding to help this project! If you have contributed to other open source projects before please note that some conventions here might be a bit different than what you have been used to. Reading this document will save you, other contributors and the developers time. +Thank you for deciding to help this project! If you have contributed to other open source projects before please note that some conventions here might be a bit different than what you are used to. Reading this document will save you, other contributors and the developers time. ## Development Ideology @@ -36,17 +36,17 @@ Please do **not** ask support questions at the issue tracker. We want to help yo Please do **not** use this issue tracker as a discussion forum. Discussion related to the bug in question should of course go to the issue itself. However other discussion should take place at the [community forum](https://whispersystems.discoursehosting.net). You can use that forum to discuss any Signal related topics or to just hang out with your fellow users. ### Don't bump issues -Every time someone comments on an issue, GitHub sends email to [everyone who is watching](https://github.com/WhisperSystems/Signal-Android/watchers) the repository (currently around 500 people). Thus bumping issues with :+1:s, _me toos_ or asking for updates just generate unnecessary email notifications. Moreover bumping an issue does not help solving it. Please be respectful to everyone's time and try to only comment when you have relevant new information to add. +Every time someone comments on an issue, GitHub sends email to [everyone who is watching](https://github.com/WhisperSystems/Signal-Android/watchers) the repository (currently around 500 people). Thus bumping issues with :+1:s, _me toos_ or asking for updates generates a lot of unnecessary email notifications. Moreover bumping an issue does not help solve it. Please be respectful of everyone's time and only comment if you have relevant new information to add. ### Open issues #### If it's open it's tracked -Have you followed all the points in the [Submitting useful bug reports guide](https://github.com/WhisperSystems/Signal-Android/wiki/Submitting-useful-bug-reports) but nobody has commented on your issue? Is there no milestone or person assigned to it? Don't worry, the developers read every issue and if it's open it means it's tracked and taken into account. It might just take time as other issues have higher priorities. And remember that this is an open source project: Anyone is encouraged to take an active role in fixing open issues. +Have you followed all the points in the [Submitting useful bug reports guide](https://github.com/WhisperSystems/Signal-Android/wiki/Submitting-useful-bug-reports) but nobody has commented on your issue? Is there no milestone or person assigned to it? Don't worry, the developers read every issue and if it's open it means it's tracked and taken into account. It might just take time as other issues have higher priority. And remember that this is an open source project: Everyone is encouraged to take an active role in fixing open issues. ### Closed issues #### "My issue was closed without giving a reason!" -Please understand that writing detailed explanations every time for every issue someone comes up with takes time. Sometimes a reason has been posted earlier to another related issue which you can search for. It's also possible that your issue was not in line with the guidelines of the project (see especially the [Development Ideology](https://github.com/WhisperSystems/Signal-Android/blob/master/CONTRIBUTING.md#development-ideology)). Or it was just simply decided that the issue is not something that Signal should do at this time. +Please understand that writing detailed explanations every time for every issue someone comes up with takes time. Sometimes a reason has been posted earlier to another related issue which you can search for. It's also possible that your issue was not in line with the guidelines of the project (see especially the [Development Ideology](https://github.com/WhisperSystems/Signal-Android/blob/master/CONTRIBUTING.md#development-ideology)), or it was decided that the issue is not something that Signal should do at this time. ## Pull requests @@ -55,7 +55,7 @@ Please understand that writing detailed explanations every time for every issue You need to sign our CLA before your pull request can be merged. You can sign it at: https://whispersystems.org/cla/ ### Follow the Code Style Guidelines -Before submitting a pull request please check that your code adheres to the [Code style Guidelines](https://github.com/WhisperSystems/Signal-Android/wiki/Code-Style-Guidelines). +Before submitting a pull request please check that your code adheres to the [Code Style Guidelines](https://github.com/WhisperSystems/Signal-Android/wiki/Code-Style-Guidelines). ### Submit only complete PRs and test them Please do not submit pull requests that are still a work in progress. Pull requests should be ready for a merge when you submit them. Also please do not submit pull requests that you have not tested. @@ -71,11 +71,11 @@ Accepted pull requests will be rewarded with Bitcoins! After your pull request h ## How can I contribute? -Any one can help by +Anyone can help by - advising new people about the guidelines of this project - redirecting support questions to support@whispersystems.org and the [support site](https://support.whispersystems.org) - redirecting non-bug related discussions to the [community forum](https://whispersystems.discoursehosting.net) -- improving documentation at the [wiki](https://github.com/WhisperSystems/Signal-Android/wiki) +- improving documentation in the [wiki](https://github.com/WhisperSystems/Signal-Android/wiki) - [translating](https://www.transifex.com/projects/p/signal-android/) - finding and marking duplicate issues - trying to reproduce issues