This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
All tests should have descriptions.
authorJames E Keenan <jkeenan@cpan.org>
Mon, 22 Oct 2012 01:49:03 +0000 (21:49 -0400)
committerJames E Keenan <jkeenan@cpan.org>
Sun, 18 Nov 2012 14:46:42 +0000 (08:46 -0600)
Porting/todo.pod

index 350ad55..9d658f3 100644 (file)
@@ -63,6 +63,14 @@ Schwern has promised to donate to $500 to TPF. We may need volunteers to
 hold him upside down and shake vigorously in order to actually extract the
 cash.
 
 hold him upside down and shake vigorously in order to actually extract the
 cash.
 
+=head2 Write descriptions for all tests
+
+Many individual tests in the test suite lack descriptions (or names, or labels
+-- call them what you will).  Many files completely lack descriptions, meaning
+that the only output you get is the test numbers.  If all tests had
+descriptions, understanding what the tests are testing and why they sometimes
+fail would both get a whole lot easier.
+
 =head2 Improve the coverage of the core tests
 
 Use Devel::Cover to ascertain the core modules' test coverage, then add
 =head2 Improve the coverage of the core tests
 
 Use Devel::Cover to ascertain the core modules' test coverage, then add