Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change
 
PerlMonks  

Re: avoiding writing readme for scripts

by KM (Priest)
on Oct 16, 2000 at 18:45 UTC ( #36916=note: print w/ replies, xml ) Need Help??


in reply to avoiding writing readme for scripts

When Larry says a virtue is to be Lazy, he didn't mean to be a Lazy SoB. Part of programming is to write the README files so users know how to use the stuff you write. Not everyone can read Perl, or read everyones style of Perl and the README helps to remedy this. If you used POD within your script, you could extract it.. otherwise, it would be good practice, especially for a student, to write a decent README for your script. Sometimes when writing how to use a script you can see things that don't make sense, aren't obvious, and things that in general would be good to fix. So, do everyone a favor, and write your README.. it is not programming, but still the work of any respectable programmer (IMO).

Cheers,
KM


Comment on Re: avoiding writing readme for scripts
RE: Re: avoiding writing readme for scripts
by Anonymous Monk on Oct 16, 2000 at 18:50 UTC
    its not that i'm lazy... its just i'm patiently challenged. Boy you guys answer these questions really fast. That's amzing.
RE (tilly) 2: avoiding writing readme for scripts
by tilly (Archbishop) on Oct 16, 2000 at 19:13 UTC
    In fact Larry wants you to turn all of those normally bad things into virtues by doing them in an enlightened manner.

    Have hubris but maintain it intact by being good enough to justify it.

    Be lazy, but think ahead to anticipate demands on your time and head them off in advance. For instance it is less work to write good documentation then call RTFM than it is to answer questions.

    Be impatient but take it out by getting to good answers fast rather than complaining.

    In other words let each deadly sin redeem itself by motivating you to act in a virtuous manner. :-)

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others avoiding work at the Monastery: (11)
As of 2014-12-26 09:48 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

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





    Results (171 votes), past polls