Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation
 
PerlMonks  

Re: RFC: Tutorial: use strict; now what!?

by RedElk (Hermit)
on Feb 08, 2012 at 17:13 UTC ( #952533=note: print w/ replies, xml ) Need Help??


in reply to RFC: Tutorial: use strict; now what!?

Under Purpose of Strictures you wrote "We often use strict; to prevent us from making stupid or careless mistakes."

Who are the ubiquitous "we" and "us"?

A direct tone would work better. For example..."Use strict; to prevent stupid or careless mistakes".

Also, the final sentence of this same paragraph is overly emphatic and not necessary. The chainguard metaphor makes your point very clear.

My 2 cents.


Comment on Re: RFC: Tutorial: use strict; now what!?
Select or Download Code
Re^2: RFC: Tutorial: use strict; now what!? (stupid)
by tye (Cardinal) on Feb 08, 2012 at 17:44 UTC
    For example..."Use strict; to prevent stupid or careless mistakes".

    A direct tone can be useful. Combining a direct tone with the word "stupid" is probably... not smart. Yes, a "stupid mistake" does not actually imply that the actor is generally stupid. But I'm sure there will be readers who are... um... not fluent enough in English to realize that. The word "careless" is not much less loaded.

    I would suggest combining the direct tone with the phrase "typographical errors (typos)". Though, not having read the tutorial, there might be another approach that better fits into it.

    - tye        

Re^2: RFC: Tutorial: use strict; now what!?
by Xiong (Hermit) on Feb 08, 2012 at 22:34 UTC

    Agreed; delete:

    <c>use strict;</c> is the <i>chainguard</i> that keeps you from ripping off your own fingers. - Use it for your own safety.
    I'm not the guy you kill, I'm the guy you buy. —Michael Clayton
Re^2: RFC: Tutorial: use strict; now what!?
by Xiong (Hermit) on Feb 09, 2012 at 12:16 UTC
    Who are the ubiquitous "we" and "us"?

    We cook your meals, we haul your trash, we connect your calls, we drive your ambulances, we guard you while you sleep.
    Do not fuck with us.

    I'm not the guy you kill, I'm the guy you buy. —Michael Clayton

      That's cute.

      But, I'm not sure you got my point. The way you employ the ubiquitous "we" and "us" in your tutorial sounds like you're talking down to your reader. Not the right tone, in my opinion.

        Talking down to the reader is broadly accepted on this site. It's the Free Software business model: you can't get paid for giving advice here, but by providing code or advice, you can earn the privilege of condescending to or verbally abusing people. See the linux-kernel mailing list or the #perl IRC channel for more examples.

        Sorry; we don't agree.

        I'm not the guy you kill, I'm the guy you buy. —Michael Clayton

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://952533]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others about the Monastery: (6)
As of 2014-12-28 07:52 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    Is guessing a good strategy for surviving in the IT business?





    Results (179 votes), past polls