You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by br...@apache.org on 2006/03/07 20:10:19 UTC
svn commit: r383963 - in /maven/site/trunk/src/site/apt/guides/development:
guide-helping.apt guide-m2-development.apt
Author: brett
Date: Tue Mar 7 11:10:17 2006
New Revision: 383963
URL: http://svn.apache.org/viewcvs?rev=383963&view=rev
Log:
improve how to help docs
Modified:
maven/site/trunk/src/site/apt/guides/development/guide-helping.apt
maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt
Modified: maven/site/trunk/src/site/apt/guides/development/guide-helping.apt
URL: http://svn.apache.org/viewcvs/maven/site/trunk/src/site/apt/guides/development/guide-helping.apt?rev=383963&r1=383962&r2=383963&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/development/guide-helping.apt (original)
+++ maven/site/trunk/src/site/apt/guides/development/guide-helping.apt Tue Mar 7 11:10:17 2006
@@ -17,6 +17,10 @@
* {{{guide-m2-development.html#Creating and submitting a patch}Submit patches}} to reported issues (both those you find, or that others have filed)
+ * Help with the documentation by pointing out areas that are lacking or unclear, and if you are so inclined, submitting patches to correct it.
+ You can quickly contribute rough thoughts to the {{{http://docs.codehaus.org/display/MAVENUSER} wiki}}, or you can volunteer to help collate and
+ organise information that is already there.
+
[]
Your participation in the community is much appreciated!
Modified: maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt
URL: http://svn.apache.org/viewcvs/maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt?rev=383963&r1=383962&r2=383963&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt (original)
+++ maven/site/trunk/src/site/apt/guides/development/guide-m2-development.apt Tue Mar 7 11:10:17 2006
@@ -3,6 +3,7 @@
------
Emmanuel Venisse
Trygve Laugstol
+ Brett Porter
------
8 July 2005
------
@@ -127,6 +128,29 @@
*.iws
*.iml
---
+
+* Patch acceptance criteria
+
+There are a number of criteria that a patch will be judged on:
+
+ * Whether it works and does what is intended. This one is probably obvious!
+
+ * Whether it fits the spirit of the project. Some patches may be rejected as they take the project in a different
+ direction to that which the current development community has chosen. This is usually discussed on an issue well
+ before a patch is contributed, so if you are unsure, discuss it there or on the mailing lists first. Feel free to
+ continue discussing it (with new justification) if you disagree, or appeal to a wider audience on the mailing lists.
+
+ * Whether it contains tests. It is expected that any patches relating to functionality will be accompanied by unit tests
+ and/or integration tests. It is strongly desired (and will be requested) for bug fixes too, but will not be the basis
+ for not applying it. At a bare minimum, the change should not decrease the amount of automated test coverage.
+ As a community, we are focusing on increasing the current coverage, as there are several areas that do not receive automated testing.
+
+ * Whether it contains documentation. All new functionality needs to be documented for users, even if it is very rough
+ for someone to expand on later. While rough is acceptable, incomplete is not. As with automated testing, as a community
+ we are striving to increase the current coverage of documentation.
+
+Above all, don't be discouraged. These are the same requirements the current commiters should hold each other to as well.
+And remember, your contributions are always welcome!
* Related Projects