Beefy Boxes and Bandwidth Generously Provided by pair Networks
Keep It Simple, Stupid
 
PerlMonks  

Re^2: Documentation: POD vs Comments

by Anonymous Monk
on Jul 22, 2011 at 13:41 UTC ( #916135=note: print w/ replies, xml ) Need Help??


in reply to Re: Documentation: POD vs Comments
in thread Documentation: POD vs Comments

"Scattering POD inline with code is Good, putting it all at the beginning or end of the file, separate from what it's documenting, is Bad." -- DrHyde.

Your "good" & "bad" situations are reverse for me. Please offer that as your personal preference but not as some kind of truth.


Comment on Re^2: Documentation: POD vs Comments
Re^3: Documentation: POD vs Comments
by Anonymous Monk on Jul 22, 2011 at 13:58 UTC

    Your "good" & "bad" situations are reverse for me. Please offer that as your personal preference but not as some kind of truth.

    Why? It is the truth according to DrHyde -- what theory of truth are you operating under?

      The quoted sentence was written without any qualifiers or disclaimers (as if everybody prefers that sentiment).

        The quoted sentence was written without any qualifiers or disclaimers (as if everybody prefers that sentiment).

        So, why does it need prefacing? Is it not obvious DrHyde is speaking?

        And I disagree, it wasn't written as if everybody prefers that sentiment

        Besides, the statement is obvious true, just like :
        Keeping related things nearby is Good, separating related things is Bad
        Keeping pennies in a jar is Good, separating pennies in toilets is Bad
        Keeping condoms in refrigerator is Good, separating condoms in bathroom is Bad.

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (14)
As of 2014-10-24 20:47 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    For retirement, I am banking on:










    Results (137 votes), past polls