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

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

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!
  • 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
  • Outside of code tags, you may need to use entities for some characters:
            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?
    Username:
    Password:

    What's my password?
    Create A New User
    Chatterbox?
    and the web crawler heard nothing...

    How do I use this? | Other CB clients
    Other Users?
    Others lurking in the Monastery: (6)
    As of 2014-09-21 10:44 GMT
    Sections?
    Information?
    Find Nodes?
    Leftovers?
      Voting Booth?

      How do you remember the number of days in each month?











      Results (168 votes), past polls