From: James E Keenan <jkeenan@cpan.org>
Date: Mon, 22 Oct 2012 01:49:03 +0000 (-0400)
Subject: All tests should have descriptions.
X-Git-Tag: v5.17.6~44
X-Git-Url: https://perl5.git.perl.org/perl5.git/commitdiff_plain/831efc5acdf0bb2216c6a5b26bc83b4f90e6d23a

All tests should have descriptions.
---

diff --git a/Porting/todo.pod b/Porting/todo.pod
index 350ad55..9d658f3 100644
--- a/Porting/todo.pod
+++ b/Porting/todo.pod
@@ -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.
 
+=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