Re^2: Documentation: POD vs Comments

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?	[reply]
Re^4: Documentation: POD vs Comments by Anonymous Monk on Jul 22, 2011 at 14:04 UTC
The quoted sentence was written without any qualifiers or disclaimers (as if everybody prefers that sentiment).	[reply]
Re^5: Documentation: POD vs Comments by Anonymous Monk on Jul 22, 2011 at 15:51 UTC
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.	[reply]
Re^6: Documentation: POD vs Comments by JavaFan (Canon) on Jul 22, 2011 at 16:46 UTC
Re^7: Documentation: POD vs Comments by Anonymous Monk on Jul 23, 2011 at 01:38 UTC


Don't ask to ask, just ask
	PerlMonks

Re^2: Documentation: POD vs Comments

The best material for plates (tableware) is: