Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister

comment on

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

I've been very busy lately, but I had to post this. I recently was reading the perl5-porters list digest (see a copy at") and came upon this section:

Casey West came up with the great idea of having a mailing list for Perl beginners. It's worth quoting extensively from his post:

I have been throwing around the idea of a central place where Perl newcomers can come and ask FAQ questions and the like. My dream is to funnel all the RTFM traffic from p5p, c.l.p.* and other such places. I would like to see a place where the newbies are accepted as people who just don't know yet. ...

There are a few crucial things that must take place in order to make this list as effective as possible:

  • Moderation. Flames must be removed at all times. It should be easy to be the newbie.
  • Direction. Archives are a valuable resource. We don't do homework.
  • Publicity. List and News Group FAQ's can and should list perl-newbies as the primary source for simple, 'new commer' questions. Questions of this nature should be immediatly redirected to perl-newbies.
  • Teachers. They can and will ask, we must answer.

So far, so good. I was thinking to myself: Wow! This sounds like the perfect description of PerlMonks. So imagine my horror at the next paragraph:

At first I thought PerlMonks was this thing, however, PerlMonks is not an environment where newbies are allowed to ask simple questions answered in the documentation.

Ouch! Is that really the reputation we are getting from some people? I can sort of see their point - some newbies *are* treated roughly around here - whether with a "do your own stinkin' homework" or a terse RTFM-like response. Certainly on the balance, however, I feel that we *do* help newbies.


Rather than turn this into a raging debate, let's tip our hats to Casey for thinking about creating yet another resource for Perl, and accept the paragraph as some constructive criticism.

I will put forth the theory almost everyone here *means* well, but perhaps some of us have forgotten what it is like to truly be a "newbie" to the world of Perl, or even to programming/computers in general. The obvious isn't. They may not know what a manpage is. They may not even know about the existence of the Camel book. They may have just had Perl thrust upon them suddenly and someone has pointed out our site as a good place for help. Let's not disappoint these people. Here are some suggestions I humbly offer:

  • Give every poster the benefit of the doubt. If the question sounds really dumb and simple, assume that the poster is sincere and has already done some research, or does not know where to find the answer. What may appear obvious to "us", may not be to most people.
  • Give a person credit for getting as far as they did - finding the site, (sometimes) creating an account, and formulating a question: this can be a big deal for someone who has never done so before. Keep in mind that a large portion of the population could probably not even get that far. Cut them some slack.
  • Sometimes it seems as if the same handful of people answer all the questions that are posted. If you post a lot, consider cutting back a little, especially if it is an easy question. This gives other people a chance to answer it, who might not have spoken up otherwise. You can always answer the harder questions. :)
  • Answer questions in a nice tone. Be friendly. Don't scare people off from the language. If you feel the need to write a terse, sarcastic, RTFM-like response, count to 10, recompile perl, then come back. As the letter above demonstrates, we are not only a source of technical answers, but also a source of perl advocacy, and a reflection upon the perl community. Treat everyone with respect, as if it was your 88 year old grandmother, who just picked up "Perl for Dummies in 24 Hours" and needs your help. It is always better to err on the side of being too nice.

In reply to PerlMonks as Ambassadors by turnstep

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 the web crawler heard nothing...

    How do I use this? | Other CB clients
    Other Users?
    Others musing on the Monastery: (6)
    As of 2021-04-21 05:58 GMT
    Find Nodes?
      Voting Booth?

      No recent polls found