----- Original Message ----
From: Gabor Szabo <[EMAIL PROTECTED]>

> I admit, I did not even know that it existed until recently.
> I guess I have not read the full documentation of Test::More and Test::Builder
> but I assume there are not many that do.
> 
> [regarding documentation of $Test::Builder::Level]

Up until I had written Test::JSON, I had never heard of it (or if I did, I 
didn't remember) and I've been writing tests for years.  The fact that this is 
such a core concept for getting reporting correct and yet so many hard-core 
testers don't know about it suggests that it should be mentioned far more 
prominently.
 
> > Should it be in Test::More?  Perhaps it should be in Test::Tutorial.  I 
> > don't
> > know.  I welcome suggestions.

I think it should be mentioned in both.  Yes, that's more work to synchronize 
this information but even Test::Builder doesn't highlight how important this is 
(http://search.cpan.org/dist/Test-Simple/lib/Test/Builder.pm#Test_style).

Now that I stop to think about it, what would be good is a new document added 
to the distribution named something like 'Test::GuideLines' or 
'Test::BestPractices' or something similar.  Once someone gets to the point of 
being comfortable with simple test scripts, they start to wonder if they're 
writing *good* test scripts.  Many tests, mine included, are just long 
procedural lists of assertions.  Organizing tests, suggestions for setting up 
test databases, etc., would be very useful.  And that, not uncoincidentally, 
would be a perfect place to highlight the importantance of $Level.

But for now, Test::More and Test::Tutorial are the best places since those have 
the docs that people read the most.

Cheers,
Ovid
 
-- If this message is a response to a question on a mailing list, please send 
follow up questions to the list.
 
Web Programming with Perl -- http://users.easystreet.com/ovid/cgi_course/





Reply via email to