summaryrefslogtreecommitdiff
path: root/pod/perlhack.pod
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2001-11-23 18:12:21 +0000
committerJarkko Hietaniemi <jhi@iki.fi>2001-11-23 17:11:58 +0000
commita936dd3cbec3db0be0468f4b4ca8007aa78279f6 (patch)
tree42ac5adbff231cb898f9c8cdfebcbd2769d87d76 /pod/perlhack.pod
parenta5b3542311a661393000cf5958d4b96624f4ef77 (diff)
downloadperl-a936dd3cbec3db0be0468f4b4ca8007aa78279f6.tar.gz
Tests are good
Message-ID: <20011123181220.F37621@plum.flirble.org> p4raw-id: //depot/perl@13208
Diffstat (limited to 'pod/perlhack.pod')
-rw-r--r--pod/perlhack.pod13
1 files changed, 11 insertions, 2 deletions
diff --git a/pod/perlhack.pod b/pod/perlhack.pod
index 49d7625ab0..371b6b5f72 100644
--- a/pod/perlhack.pod
+++ b/pod/perlhack.pod
@@ -157,13 +157,22 @@ The worst patches make use of a system-specific features. It's highly
unlikely that nonportable additions to the Perl language will be
accepted.
+=item Is the implementation tested?
+
+Patches which change behaviour (fixing bugs or introducing new features)
+must include regression tests to verify that everything works as expected.
+Without tests provided by the original author, how can anyone else changing
+perl in the future be sure that they haven't unwittingly broken the behaviour
+the patch implements? And without tests, how can the patch's author be
+confident that his/her hard work put into the patch won't be accidently
+thrown away by someone in the future?
+
=item Is there enough documentation?
Patches without documentation are probably ill-thought out or
incomplete. Nothing can be added without documentation, so submitting
a patch for the appropriate manpages as well as the source code is
-always a good idea. If appropriate, patches should add to the test
-suite as well.
+always a good idea.
=item Is there another way to do it?