Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change

PerlMonks Sections

by SiteDocClan
on Mar 17, 2008 at 18:30 UTC ( #674621=faqlist: print w/replies, xml ) Need Help??

(Note: This page is "better" than Where should I post X? and predecessors, because it pulls in the actual doclets associated with each section. Those are what are displayed at the top of each section, and are authoritative.)

This page should help you figure out where to submit your post. Posts submitted to the wrong section run the risk of being moved, down-voted, edited, or even deleted. If you see a node posted in an inappropriate section, please alert the janitors, or consider it to have it moved to the correct section.

If what you want to post is employment related (e.g. if you're trying to hire or be hired), the place to post is at, not here. (See May I post a job ad?)

These are the available sections of PerlMonks:

PerlMonks Sections


Seekers of Perl Wisdom  (Top)

If you have a question on how to do something in Perl, or you need a Perl solution to an actual real-life problem, or you're unsure why something you've tried just isn't working... then this section is the place to ask. Post a new question!

However, you might consider asking in the chatterbox first (if you're a registered user). The response time tends to be quicker, and if it turns out that the problem/solutions are too much for the cb to handle, the kind monks will be sure to direct you here.

Cool Uses for Perl  (Top)

This section is the place to post your general code offerings -- everything from one-liners to full-blown frameworks and apps.

Meditations  (Top)

If you've discovered something amazing about Perl that you just need to share with everyone, this is the right place.

This section is also used for non-question discussions about Perl, and for any discussions that are not specifically programming related. For example, if you want to share or discuss opinions on hacker culture, the job market, or Perl 6 development, this is the place. (Note, however, that discussions about the PerlMonks web site belong in PerlMonks Discussion.)

Meditations is sometimes used as a sounding-board — a place to post initial drafts of perl tutorials, code modules, book reviews, articles, quizzes, etc. — so that the author can benefit from the collective insight of the monks before publishing the finished item to its proper place (be it Tutorials, Cool Uses for Perl, Reviews, or whatever). If you do this, it is generally considered appropriate to prefix your node title with "RFC:" (for "request for comments").

Perl Monks Discussion  (Top)

Do not post your Perl questions here!

This section is only for discussing issues pertaining to the PerlMonks web site itself. For example, asking about how things work, or offering ideas on how the site could be made better.

Unless the topic pertains to the PerlMonks web site itself, it does not belong in this section. If you're even the least bit unsure, check out Where should I post X? and The Perl Monks Guide to the Monastery, or ask in the chatterbox.

Categorized Questions and Answers  (Top)

This section is PerlMonks' own ever-growing compendium of Perl knowledge, framed in a question-and-answer format.

Topics range from the mundane (including questions which are answered in the official Perl FAQ) to the esoteric.

If you're faced with a problem and your inclination is to think "I'm sure someone has solved this already," then check here first. You can browse the categories, or you can use Super Search, narrowing the query to just Categorized Questions and/or Categorized Answers.

This section emphasizes quality and succinctness. Questions should be precisely worded to elicit specific answers. (Of course, there's always more than one way to do things, so each question may have multiple answers.) Questions phrased (even unintentionally) to elicit discussion are not appropriate for this section.

The content presented in a Question and its Answers should also be of general interest to the Perl programming community. If the asker is the only person who could benefit from the answers, then the question is subject to being moved to SoPW.

Categorized Questions and Answers is supervised by the QandAEditors, a group of monks specially commissioned by the gods to maintain the quality of this section. They are empowered to edit and even delete Questions and Answers, and they can move inappropriate Questions to the SoPW section. For more detail, see How does editing work in the Q&A section?

Questions can be submitted by any Monk of at least Level 5: Beadle. In general, we'd like the submitter of a Question also to submit at least one Answer to that question. However, that is not a requirement.

If you have a good idea for a Categorized Question but you're not yet of Level 5: Beadle, or you don't know how to write the question appropriately, feel free to suggest it to QandAEditors.

The Categorized Questions and Answers section works a little bit differently from the other sections, in that Questions and Answers, once posted, belong jointly to the author and to the QandAEditors. For more info, see Why are categorized questions and answers displayed separately from the rest of my writeups?

This section has Categories.

Tutorials  (Top)

This section is an ever-growing online textbook, from which you can learn the basics of Perl, or some nifty stuff you haven't seen before.

Should I post here?

While you can post directly to the Tutorials section, this has certain drawbacks. A generally better approach is to follow this procedure:

  1. Write up your draft tutorial and put it in your scratchpad; broadcast requests for comments in the chatterbox and elsewhere.
    After revising,
  2. Post it as a new Meditation, with "RFC" in the title.
    Later, if it is generally acclaimed to be worthy of Tutorials, but needs more work first, then make the necessary revisions and
  3. Post the final version as a Tutorials node.
Since ideally the Tutorials section has a high value-to-noise ratio, tutorial documents should be in as finished a state as possible before being posted to that section. (Not that it's the end of the world if they aren't.)

If you would be interested in writing a Tutorial but aren't sure what to write about, or if you have an idea for a Tutorial but can't commit to writing it — check out the Tutorials Quest!

Also of interest: How does editing work in the Tutorials section?

If you have Tutorials-related questions or requests, you may /msg them to Pedagogues.

Obfuscated code  (Top)

Got some code which would take a Perl grand master to understand without running it? Post it in this section so we can stare at it in awe.

Word of warning, though: Don't be too cocky with your post — almost inevitably someone will post a reply that does the exact same thing in even fewer characters!

Perl Poetry  (Top)

"Poetry" is in the eye of the beholder; it could be any of:
  • Poetry written in Perl
  • Using perl to generate poetry
  • Poetry about Perl/PerlMonks

Perl News  (Top)

For the latest news on what's happening in the Perl world, check out these sites:

If you have a Perl-related news item you'd like to share, you may post it in the Perl News section. Please try to avoid duplicating news; but pointers (with summaries) to important stories on other sites are acceptable here.

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 wandering the Monastery: (2)
As of 2020-10-25 00:16 GMT
Find Nodes?
    Voting Booth?
    My favourite web site is:

    Results (248 votes). Check out past polls.