http://www.perlmonks.org?node_id=916135


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.