Re: Docs Testing Format (was Re: HOWTO: Writing Perl6 Tests)
[email protected] (Michael Lazzaro)
| Newsgroups | perl.perl6.documentation |
|---|---|
| Message-ID | <[email protected]> |
On Tuesday, November 12, 2002, at 10:01 AM, Brent Dax wrote: > Why use POD like this instead of a more atomic version of the standard > testing format used by Perl 5? We can use the directory structure to > organize things. Since most tests are not worthy of inclusion in the > docs (do you really want "$foo eq reverse scalar reverse $foo" in the > documentation for reverse()?) I don't see why we can't do this. Dunno, looking for a way where we can harness the authors for producing tests in the least-intimidating way. I'm not really thinking that the tests will be a useful, displayable part of the docs, but I figure the closer we can tie it into writing each docs section, the more likely we'll be to get contributors to actually think about it & do it. I could be wrong there, tho... MikeL