I have tried several approaches to the baby-perl versus no-holds-barred-perl problem. I think the best approach is to write code that is an achievable challenge for your audience to understand. It should be difficult enough that the reader feels a sense of accomplishment in reading it. It should not be so difficult that the reader does not stand a chance.

More difficult code can be buried within a module. A module is an extension of the language itself. If properly written, it can be used without having to understand how it works. The audience is simply told, "Use this module and don't worry."

Japhy writes a clear explanation sufficient to guide a novice through the advanced code in the example. His explanation proves to us why we should all buy Japhy's book, should he decide to write it! Not all of us have the time or talent to write such a clear explanation. We should tame our code until it is barely within the reach of our audience. Japhy tames his code by showing how it is developed.

I have the pleasure of working with a fellow who doesn't know perl at all, but he is confident that he will be able to follow, use, and modify my code. He has been reading my copy of Learning Perl. His willingness to stretch his capabilities makes him more valuable and more fun to work with. He knows he can ask me questions if he runs into something opaque. He doesn't want to suppress my creativity with his temporary personal limitations. Between his confidence and my somewhat conservative coding style, we enjoy the collaboration.

It should work perfectly the first time! - toma

In reply to Re: Helping Beginners by toma
in thread Helping Beginners by Ovid

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.