|
From: <sv...@va...> - 2005-06-30 01:02:58
|
Author: njn Date: 2005-06-30 02:02:54 +0100 (Thu, 30 Jun 2005) New Revision: 124 Log: Completely overhaul the contributions page. Modified: trunk/support/contributing.html Modified: trunk/support/contributing.html =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/support/contributing.html 2005-06-30 00:44:02 UTC (rev 123) +++ trunk/support/contributing.html 2005-06-30 01:02:54 UTC (rev 124) @@ -1,96 +1,74 @@ <h1>Contributing to Valgrind</h1> =20 -<ul> - <li><a href=3D"#why">Why should I contribute?</a></li> - <li><a href=3D"#cost">Is there a cost to participate?</a></li> - <li><a href=3D"#fave">Become involved with your favorite tool</a></li> - <li><a href=3D"#where">If I donate financially, where would my donation= s go?</a></li> - <li><a href=3D"#talk">I'd like to talk to someone about supporting Valg= rind</a></li> - <li><a href=3D"#donate">Donations</a></li> -</ul> +If you would like to contribute to Valgrind's development, there are a +number of ways you can help. =20 +<h3>Bug Reports</h3> +Bug reports are good. Good bug reports are even better. They should be +submitted to our Bugzilla site (instructions are=20 +<a href=3D"/support/bug_reports.html">here</a>). Please follow the guid= elines +about writing good bug reports. Small sample programs that exhibit a bu= g +are particularly helpful. =20 -<a name=3D"why"></a> -<h3>Why should I contribute?</h3> +<h3>Testing</h3> +<p>If you can regularly test Valgrind on a range of different systems, t= hat +can be very helpful. Please contact the <?php echo vglink( 'vgdevel' ); = ?> +list for more information.</p> =20 -<p>As a volunteer-based organization, Valgrind stands most in -need of dedicated volunteers who can work on software, -documentation, or administrative issues. While all of the -administrative effort is currently through unpaid volunteers, we -need financial assistance to purchase bandwidth and keep our -servers running.</p> +<h3>Documentation</h3> +Valgrind's documentation is not always kept up to date. Any documentati= on +patches that help in this respect are welcome. Please send them to the +<?php echo vglink( 'vgdevel' ); ?> list. =20 +<h3>Code</h3> +<p>If you want to contribute new code to Valgrind, you should subscribe = to +the <?php echo vglink( 'vgdevel' ); ?> list.</p> =20 -<a name=3D"cost"></a> -<h3>Is there a cost to participate?</h3> +<p>There are various kinds of code you can contribute.</p> +<ul> +<li>Bug fixes are always welcome. Please consult the Bugzilla page for = the + current bug list. Patches should be submitted to the relevant Bugzi= lla + page.</li> =20 -<p>Absolutely not! Valgrind is committed to providing free access -to all interested participants. All of our code is distributed -under the=20 -<a href=3D"http://www.gnu.org/licenses/gpl.html">GNU Public -Licence</a>. The mailing lists are open to the public and -contributors are usually welcomed with open arms.</p> +<li>Ports to new platforms are also welcome. Note that porting is a big + task, and so it is worth asking on the + <?php echo vglink( 'vgdevel' ); ?> list + first if anyone else is working on a port to your chosen platform. + Ports require a very good knowledge of the platform you are porting = to. + Ports to widely used platforms are preferable.</li> =20 -<p>So, there is no cost required to contribute code. However, -there is usually a substantial time committment that is required -in order to contribute. For some, time is cheaper than money. For -others, money is cheaper than time (lucky you). We realize that, -and want to promote contributions from everyone - no matter the -form.</p> +<li>We are very conservative about adding new features. Only features + that are useful to many users, and that do not affect the code base = in + adverse ways are likely to be accepted. If you want to add a featur= e, + it is worth asking on the <?php echo vglink( 'vgdevel' ); ?> list if= it + is likely to be incorporated before starting.</li> +</ul> =20 +<p>Please understand that there is no guarantee that code you write will= be +incorporated into Valgrind. It depends on a number of factors: how well +written it is, how important are the issues it addresses, how does it af= fect +the code base's structure, and so on. Such is the nature of all free +software projects. However, if you consistently submit high quality +patches, you may be granted write access to the repository. This is how +most of the current developers got involved with Valgrind.</p> =20 -<a name=3D"fave"></a> -<h3>Become involved in your favorite tool</h3> +<h3>Money</h3> +<p>Donations are welcome, large or small. They help pay day-to-day +running costs, such as bandwidth, web-hosting, electricity, and hardware +maintenance, as well as helping with larger one-off costs such as +buying new machines.</p> =20 -<p>The first way you can help is to contribute your time to your -favorite tool. There is always a need for participants in each -tool. We also value reporting of problems to our tracking systems -- a valuable contribution.</p> +<p>Individuals and companies can donate funds to support Valgrind by che= que +or money order. Please <a href=3D"/info/contact.html#email">contact us<= /a> +if you wish to donate.</p> =20 +<h3>Equipment</h3> +<p>Equipment donations can be very useful. If you wish to donate some +equipment, please <a href=3D"/info/contact.html#email">contact us</a> to= find +out if the equipment would be useful, and if so, to arrange its +transport.</p> =20 -<a name=3D"where"></a> -<h3>If I donate financially, where would my donations go?</h3> +<h3>Other</h3> +For any other questions about these matters, please=20 +<a href=3D"/info/contact.html#email">contact us</a>. =20 -<p>If you'd like to contribute financially, we would greatly -appreciate it. Currently, the bulk of our financial obligations -are going towards providing our technical infrastructure - the -servers and bandwidth that we require.</p> - -<p>If you have a specific target or tool that you wish to -directly support, please=20 -<a href=3D"/info/contact.html#email">contact us</a> and we will do -our best to satisfy your wishes.</p> - -<p>If you wish to provide equipment for use by the Valgrind -Developers, please <a href=3D"/info/contact.html#email">contact -us</a> before attempting to send it "here" directly -- the nature -of our virtual enterprise is such that the equipment and services -used to support our projects are located all over the world.</p> - - -<a name=3D"talk"></a> -<h3>I'd like to talk to someone about supporting Valgrind</h3> - -<p>If you would like more information about supporting Valgrind, -please <a href=3D"/info/contact.html#email">contact us</a> for more -information. All information will be kept in strictest -confidence.</p> - - - -<a name=3D"donations"></a> -<h3>Donations</h3> - -<p>Individuals and companies can donate funds to support -Valgrind by cheque or money order. Please=20 -<a href=3D"/info/contact.html#email">contact us</a> for our snail -mail address.</p> - -<p>Please include the name under which you wish the donation to -be credited, either your own or the third-party if it is a gift -on behalf of someone else, and an e-mail address to which we can -acknowledge receipt. This information will not be used for any -other purpose. We will send a physical receipt by normal mail for -any donations of #100 or more, provided you include a return -address.</p> - |