Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic
 
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.

Replies are listed 'Best First'.
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 a log crumbles through the grate...

How do I use this? | Other CB clients
Other Users?
Others imbibing at the Monastery: (2)
As of 2016-12-11 01:11 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    On a regular basis, I'm most likely to spy upon:













    Results (168 votes). Check out past polls.