develooper Front page | perl.perl5.porters | Postings from July 2011

Re: [PATCH] [DOCS] Modernize perlopentut.pod

Thread Previous | Thread Next
From:
Jesse Vincent
Date:
July 20, 2011 13:10
Subject:
Re: [PATCH] [DOCS] Modernize perlopentut.pod
Message ID:
20110720201041.GC22627@fsck.bestpractical.com



On Wed, Jul 20, 2011 at 05:05:15PM -0300, Mike Doherty wrote:
> On 11-07-20 02:29 PM, Jesse Vincent wrote:
> > Perl's built in tutorial documentation should steer new users in a
> > reasonable direction and provide them with the tools they need to
> > write good Perl code.  When a tutorial tries to be exhaustive, it ends
> > up exhausting and often fails at its primary goal.
> >
> > Similarly, I don't think perlopentut.pod should cover one-arg open.
> 
> At the end of perlopentut, there is a bevy of miscellaneous tips and
> tricks. I'd be curious as to your view on their inclusion. Some,
> like specifying encoding, deserve their own more prominent and
> expanded section. However I'm not sure all of this needs to stay...

If they're not currently documented elsewhere, they should either stay
or move. They shouldn't be discarded unless they're just plain wrong.


> -Mike

-- 

Thread Previous | Thread Next


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