Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl: the Markov chain saw
 
PerlMonks  

Comment on

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

Tradução em Português

Oftimes, when Monks seek Wisdom, they are admonished by fellow Monks to make sure they have their FAQs straight, or worse, told to RTFM. However, new Monks are often intimidated or confused by the information available and are hoping for a clearer explanation. Also, the newest of the new often don't know where to find documentation.

I am perfectly willing to grant absolution to a fellow Monk for such venial sins. However, there is one sin that verges on mortal: failure to reduce your problem to a minimal test case.

Several examples are this post by vnpandey, this post by the ubiquitous Anonymous Monk, and also this node which isn't even Perl, but is the output from make install! These posts contain in excess of 250 lines of code.

Now contrast those nodes with kudra's recent post. kudra took the time to to reduce the code to a minimal test case so that we could focus on the problem and not be distracted. All monks should consider this. There are several benefits to this.

  1. You don't annoy fellow monks (that link is a joke. I personally like the kid).
  2. You don't find yourself in the Hall of Shame.
  3. Monks are more likely to offer assistance.
  4. And most importantly: you can focus on the problem.
That last point is critical. You can even forget the other three. More than once, in trying to isolate a problem, I have attempted to strip it to a minimal test case. Often, by removing clutter, the problem has stood out like a beacon. Other times, by stripping "irrelevant" code, the problem has gone away and I found the "irrelevant" code to be the problem.

So please, let's try to be more considerate and reduce our code as much as is feasible before we post. You'll learn more about your code, about coding in general, and are more likely to have relevant answers to your questions.

Cheers!
Ovid


In reply to Before You Post ... 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!
  • 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 meditating upon the Monastery: (7)
    As of 2014-07-12 05:01 GMT
    Sections?
    Information?
    Find Nodes?
    Leftovers?
      Voting Booth?

      When choosing user names for websites, I prefer to use:








      Results (238 votes), past polls