develooper Front page | perl.perl5.porters | Postings from May 2000

RE: Thoughts on maintaining perl

From:
Tzadik and Sheva Vanderhoof
Date:
May 25, 2000 19:14
Subject:
RE: Thoughts on maintaining perl
Message ID:
LPBBIFCKPBKNEALJCGOHAEDCCBAA.stvhoof@nni.com
>> I'm not saying this same problem doesn't exist in all
>> other languages, just that perl has so many ways to do
>> things that the problem is much larger.

>my experience has been the opposite, due to the tremendous
>quality of the manual.

For the benefit of those who have been involved in Perl for a while to the
exclusion of other languages, let me remind you: Perl's documentation is
superb.  Don't take it for granted.  It should be a major factor in
advocacy.

I've been working for a while now in ColdFusion, after working for the
previous while in Perl, and the difference is night and day.  The CF
documentation is often just plain wrong, telling you that the language does
something that it doesn't.  More often, its information is vague and
inprecise...  you read something and immediately 2 or 3 questions about it
come to mind which are never answered.  I've learned not to trust the
documentation and resort to testing things out to find out how they work...
of course technically that means I'm relying on undocumented behavior, but
the poor quailty of the documentation forces me to do this.  Perl's
documentation is not perfect, but it's definitely on the high quality side
compared to what's out there.





nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About