Beefy Boxes and Bandwidth Generously Provided by pair Networks
more useful options

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

There seems to be some difficulty by many here in understanding what it is you want. My own interpretation is that you would like access to a repository of nodes which take apart pieces of code (or algorithm implementations) and explain them in a spoken language, in terms that are understandable by a layman.

The problem with this IMO is the misconception that code expressed in English would be clearer than the same code expressed in Perl. Spoken languages are unsuitable for explaining algorithms in a concise and unambiguous manner. Think about it, if code could be expressed well in English, don't you think somebody would have written a complier to translate (a limited subset of) English to executable code? Contrary to what you may believe, Perl is not a limited subset of English, rather it is a language designed to express algorithms while achieving a reasonable compromise between a.) translatability of these expressions into machine code and b.) being intuitively understandable and learnable for speakers of natural languages.

Your problem (I think) is that you haven't made the jump to "thinking in Perl", which is necessary to program anything more than trivial. The translation route "Problem" -> "English description of the solution" -> "Perl implementation of the solution" will only get you so far, you need to get rid of the middle step. Accordingly, a "cheat sheet" translating Perl idioms into English (which I think is what you're after) is only of very limited usefulness and I don't think you'll get too many people excited about it.

BTW, your update seems rather counterproductive to me, since you are proposing an addition to this site and thus it is is your obligation to explain to people here why you think your idea is a good one, not the other way around.

All dogma is stupid.

In reply to Re: A proposal: new section on Perl Monks. by tirwhan
in thread A proposal: new section on Perl Monks. by Win

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, 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, 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.
  • Log In?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others meditating upon the Monastery: (4)
    As of 2018-04-21 03:54 GMT
    Find Nodes?
      Voting Booth?