From d77c58b6c78b1fd4c593b25b2ab1fb83dba3e9d9 Mon Sep 17 00:00:00 2001 From: Michael Carbone Date: Sun, 13 Nov 2016 16:12:58 -0500 Subject: [PATCH] make more inviting, improve language I modified it to get it closer to [best practices for contributing pages](https://github.com/nayafia/contributing-template/blob/master/CONTRIBUTING-template.md) --- basics_dev/contributing.md | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/basics_dev/contributing.md b/basics_dev/contributing.md index e3cf2d38..3664aff4 100644 --- a/basics_dev/contributing.md +++ b/basics_dev/contributing.md @@ -11,24 +11,28 @@ redirect_from: How can I contribute to the Qubes Project? ========================================== -Ok, so you think Qubes Project is cool and you would like to contribute? You are very welcome! +Thank you for your interest in contributing to the Qubes OS project! -First you should decide what you are interested in (and good in). The Qubes project would welcome contributions in various areas: +Following these guidelines helps communicate you respect the time of the developers managing and developing this open source project. In return, they will reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests. -- Testing and [bug reporting](/doc/reporting-bugs/) -- Code audit (e.g. gui-daemon) -- New features -- Artwork (plymouth themes, KDM themes, installer themes, wallpapers, etc) -- [Documentation](/doc/doc-guidelines) +There are many ways to contribute to the Qubes OS project: -Perhaps the best starting point is to have a look at the [issues](https://github.com/QubesOS/qubes-issues/issues) to see what are the most urgent tasks to do. +- writing turorials or recording video demos +- testing and [bug reporting](/doc/reporting-bugs/) +- auditing code +- requesting or implementing new features +- creating artwork (plymouth themes, KDM themes, installer themes, wallpapers, etc) +- writing [documentation](/doc/doc-guidelines) -Before you engage in some longer activity, e.g. implementing a new feature, it's always good to contact us first (preferably via the [qubes-devel](/doc/mailing-lists/) list), to avoid a situation when two or more independent people would work on the same feature at the same time, doubling each other's work. When you contact us and devote to a particular task, we will create a ticket for this task with info who is working on this feature and what is the expected date of some early code to be posted. +The best starting point is to have a look at the [issues](https://github.com/QubesOS/qubes-issues/issues) to see what are the most urgent tasks to do. You can filter issues depending on your interest and experience, such as: -When you are ready to start some work, read how to [access Qubes sources and send patches](/doc/source-code/). +- [help wanted](https://github.com/QubesOS/qubes-issues/issues?page=3&q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22&utf8=%E2%9C%93) +- [UX and usability](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+is%3Aopen+label%3AUX) +- [Windows tools](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+is%3Aopen+label%3A%22C%3A+windows+tools%22) +- [Documentation](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+is%3Aopen+label%3A%22C%3A+doc%22) +- [privacy](https://github.com/QubesOS/qubes-issues/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aopen%20label%3A%22privacy%22%20) +- [Debian](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+is%3Aopen+label%3A%22C%3A+Debian%22) -You can also contribute in other areas than coding and testing, e.g. by providing mirrors for Qubes rpm repositories, providing feedback about what features you would like to have in Qubes, or perhaps even preparing some cool You Tube videos that would demonstrate some Qubes' features. You are always encouraged to discuss your ideas on qubes-devel. +Before you engage in an activity that will take you a significant amount of time, e.g. implementing a new feature, it's always good to contact us first, preferably via the [qubes-devel](/doc/mailing-lists/) list. When you contact us and devote to a particular task, we will create a ticket for this task with info who is working on this feature and what is the expected date of some early code to be posted. -You should be aware, however, that we will not blindly accept all the contributions! We will accept only the quality ones. Open source doesn't mean lack of quality control! If we reject your patch, please do not get discouraged, try fixing it so that it adheres to the required standards. We will only reject contributions in the good faith, to make Qubes a better OS. - -Thanks, [The Qubes Project team](/team). +If you are interested in contributing code, please read how to [access Qubes sources and send patches](/doc/source-code/).