[Date Prev][Date Next][Thread Prev][Thread Next] [Search] [Date Index] [Thread Index]

Re: [MacPerl] Another call for code!



In article <mac-perl.v04011754b1f8c6080649@[10.48.0.42]>, Vicki Brown
<vlb@cfcl.com> wrote:

>My recommendation is plain text for anything that can possibly be sent as
>plain text. This allows people to view it within their web browser
>without requiring a download.

This is one area in which I think the CPAN is really weak, and maybe your
site could serve as a model. On the CPAN, the ReadMe's often just say
things along the lines of "this update fixes the long-standing whatever
bug" and you have to download the actual package to get at the docs which
say what the thing actually does. I'm rather shocked, actually, given
Perl's pod2html and CGI capabilities. I would have expected that there
would be html versions of the included/embedded pod documentation
generated on-the-fly. Just having informative ReadMe's would be a good
start.
-- 
__________________________________________________________________________

Jeff Clites                Online Editor           http://www.MacTech.com/
online@MacTech.com         MacTech Magazine
__________________________________________________________________________

***** Want to unsubscribe from this list?
***** Send mail with body "unsubscribe" to mac-perl-request@iis.ee.ethz.ch