Clear questions and runnable code
get the best and fastest answer
PerlMonks Sectionsby SiteDocClan
|on Mar 17, 2008 at 18:30 UTC||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.
These are the available sections of PerlMonks:
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.
This section is the place to post your general code offerings -- everything from one-liners to full-blown frameworks and apps.
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").
This section is only for discussing issues pertaining to the PerlMonks web site. You can ask about how things work, or offer ideas on how the site could be improved, for example.
Unless the topic pertains to the PerlMonks web site, it does not belong in this section. If you're unsure, check out Where should I post X? and The Perl Monks Guide to the Monastery, or ask in the chatterbox.
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.
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.
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:
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?
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!
"Poetry" is in the eye of the beholder; it could be any of:
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.