develooper Front page | perl.perl5.porters | Postings from April 2010

Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelines

Thread Previous | Thread Next
From:
Abigail
Date:
April 10, 2010 09:24
Subject:
Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelines
Message ID:
20100410162427.GK17977@almanda
On Sat, Apr 03, 2010 at 02:42:26AM +0300, Jari Aalto wrote:
> 
> Pick any non-programmer from the street and show them "&&" or the
> alternative "and", I bet my money, that they know the English word
> spelled out. But they fail to understand meaning of "&&" without "a
> priori" explanation of the showed context.

Who cares about the non-programmer?

Please, let's write documentation for *programmers*. Let's not waste
time writing documentation for people who aren't interested in it.

Non-programmers are irrelevant in this context.


>                                            This would be inherently an
> unfair contest to start with, because it helps that mathematic boolean
> tables are teached using words OR and AND in schools.


Only in some parts of the world.



Abigail
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