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

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

Thread Previous | Thread Next
From:
Aristotle Pagaltzis
Date:
July 20, 2011 08:06
Subject:
Re: [PATCH] [DOCS] Modernize perlopentut.pod
Message ID:
20110720150607.GE16631@klangraum.plasmasturm.org
* Abigail <abigail@abigail.be> [2011-07-20 14:25]:
> On Wed, Jul 20, 2011 at 12:03:54PM +0000, Ed Avis wrote:
> > Indeed there is a case for two separate tutorials:
> >
> >     A.  How to open a file.
> >
> >     B.  How to use Perl's magic 'open' to do interesting
> >         things with redirections and shell pipelines,
> >         provided you understand that it's not in general safe
> >         to use string interpolation with a user-provided
> >         filename.
> >
> > We do not help beginners by giving them (B) purporting to be
> > (A).
>
> Indeed.
>
> And we help (beginners or otherwise) even less by pretending
> B doesn't exists, or (worse) that it's something evil.

I think everyone agrees on that. I didn’t see anyone pushing for
the opposite – Mike asked “do we even want B?” but was open to
convincing. Everyone else with a firm opinion that the document
needs to change has been arguing only that A should be in the
document sooner than B, not that B should be removed completely.

Hopefully “in a tutorial we should show them A first, and only
then B” is something you can agree with? Or do you see a strong
argument against that?

Regards,
-- 
Aristotle Pagaltzis // <http://plasmasturm.org/>

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