I apologize for the negative tone of my response, but I didn't find much that was positive in your original post (unless one considers that it elicited some thoughtful replies). It appears to me to promote "elitist" views that are not IMHO conducive to a learning or community environment.

Should we infer from you first paragraph that GNU/GPL/OpenSource code shouldn't meet professional standards? Do you feel that the genius of your contribution outweighs any responsibility for professional standards?

If you don't want morons to hack your code, don't put it where they can get to it. Do you really think morons won't "defile" your code just because they don't understand it or you don't comment it?

I think it is commendable that you want to save coders time and educate perl scripters. But educate them in what, the art of obfuscation? If you want to educate them, show them code that is as well documented as it is coded and useful.

--Jim

In reply to Re: Commenting One's Code . . . by jlongino
in thread Commenting One's Code In A GNU/GPL/OpenSource World by Revelation

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.