sitefaqlet
SiteDocClan
<!--
2003-02-20 [boo_radley] faqlet creation
2003-02-20 [BigLug] FAQlet Overview AutoUpdate
2003-02-20 [BigLug] Copied from [9953] 1.0
2003-02-24 [BigLug] FAQlet Overview AutoUpdate
2003-02-24 [BigLug] Rewritten and Updated. - 2.0
2003-02-24 [BigLug] Fixed non-closed a-name tags (thanks Pfaut). - 2.1
2003-02-26 [BigLug] FAQlet Overview AutoUpdate
2003-03-04 [BigLug] Added 'looking for old' notice in
2003-03-04 [BigLug] FAQlet Overview AutoUpdate
2003-03-05 [BigLug] FAQlet Overview AutoUpdate
2003-03-18 [BigLug] Fixed non-closed a-href tags (thanks Boo_Radley). - 2.2
2003-08-25 [jdporter] closed li tags. removed alt text from pm links
2003-10-28 [Mr. Muskrat] removed erroneously cross-posted comments
2004-07-08 [TheOrbTwo] Added another item to Poetry
2004-08-18 [ysth] remove Conference reviews from Reviews list
2004-09-23 [jdporter] Added link to PM's Guide to the M
2005-03-12 [BigLug] Suggested an update to Meditations description; see the comment
2005-10-31 [jdporter] Added note about job ads
2006-03-16 [jdporter] delort non-postable sections
-->
<h1>Where should I post <i>X</i>?</h1>
<p>(Note: This page is "superseded", more or less, by [PerlMonks Sections], which pulls in the actual doclets associated with each section. Those are what are displayed at the top of each section, and they are authoritative. Content on this page could be out of date or out of sync with reality.)</p>
<p>
This FAQlet should help you decide 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 [/msg|alert] the [janitors],
or [id://92975|consider] it to have it moved to the correct section.
</p>
<p>Read this page carefully before you post to make sure you do it right.</p>
<p>
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 [http://jobs.perl.org/|jobs.perl.org], <b>not here</b>. (See [id://504424])
</p>
<h2>Sections</h2>
<ul>
<li><a href="#sopw">Seekers of Perl Wisdom</a></li>
<li><a href="#meditations">Meditations</a></li>
<li><a href="#discuss">Perl Monks Discussion</a></li>
<li><a href="#qanda">Categorized Questions and Answers</a></li>
<li><a href="#cufp">Cool Uses for Perl</a></li>
<li><a href="#obfu">Obfuscated code</a></li>
<li><a href="#poetry">Perl Poetry</a></li>
<li><a href="#news">Perl News</a></li>
<li><a href="#reviews">Reviews</a></li>
<li><a href="#tutorials">Tutorials</a></li>
</ul>
<dl>
<a name="sopw"></a>
<dt><b>[id://479] (SoPW)</b></dt><dd><p>
This is the most frequented section of PerlMonks.
If you have a question on how to do something in Perl, or you need a Perl
solution to a real-life problem, or you're unsure why something
you've tried isn't working, then SoPW is the place to ask,
especially if you've got more than a single line of code to show
with your question.
</p><p>
However, you might consider asking in the [id://236794|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 to SoPW (or wherever
the correct place might be).
</p></dd>
<a name="meditations"></a>
<dt><b>[id://480]</b></dt><dd><p>
This is the place to share your thoughts on Perl (the language or the
community), information technology, life as a programmer, or other related topics.
This section is for <i>non-question</i> discussions.
(However, discussions about Perl<i>Monks</i> belong in [id://1040].)
</p><p>
One more thing: [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 Perl monks before publishing the finished item to
its proper place (be it [id://954], [id://1747], [id://21144], or whatever).
If you do this, it is generally considered appropriate to prefix your node
title with "RFC:" (for "Request For Comments").
</p></dd>
<a name="discuss"></a>
<dt><b>[id://1040]</b></dt><dd><p>
This area is for discussing issues pertaining to the PerlMonks site.
You can ask about how things work, or offer ideas on how the site could be improved, for example.
</p><p>
Unless the topic pertains to the PerlMonks web site, <i>it does not belong in this section</i>.
For additional guidance, try [id://519263], or ask in the chatterbox.
</p></dd>
<a name="qanda"></a>
<dt><b>[id://1843]</b></dt><dd><p>
This is PerlMonks' own ever-growing compendium of Perl knowledge,
framed in a question-and-answer format.
</p><p>
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.
</p><p>
Each Question and its Answers should be tightly focused, yet
of general interest to the Perl programming community.
If the asker is the only person who could benefit from the
answers, or if the question is vague or open-ended,
then it is subject to being moved to [id://479] (SoPW).
</p><p>
Note that you must be at least [id://198665] to post Questions in this section.
</p></dd>
<a name="cufp"></a>
<dt><b>[id://1044]</b></dt><dd><p>
This is the best place for general Perl code offerings.
(For specialized posting types, see the next two sections.)
</p></dd>
<a name="obfu"></a>
<dt><b>[id://1597]</b></dt><dd><p>
<ul>
<li>Code whose function is not immediately apparent to anyone</li>
<li>Make your code as compact as possible, get rid of that needless
whitespace, make things as confusing as possible.</li>
<li>Don't be too cocky with your post. You'll (almost) always get a
reply which does the exact same thing in even less characters</li>
</ul>
</p></dd>
<a name="poetry"></a>
<dt><b>[id://1590]</b></dt><dd><p>
<ul>
<li>Poetry written in perl</li>
<li>Using Perl to write Poetry</li>
<li>Using Perl to (imaginatively) output a poem</li>
<li>Poetry about Perl and/or programming</li>
</ul>
</p></dd>
<a name="news"></a>
<dt><b>[id://23771]</b></dt><dd><p>
If you have a legitimate news item for the whole Perl community, you should probably post it at one of the following:
<ul>
<li>[http://perlisalive.com/|Perl is Alive] </li>
<li>[http://www.PerlBuzz.com/|PerlBuzz]</li>
<li>[http://use.perl.org/|Use.Perl]</li>
</ul></p><p>
However, if you really only want to broadcast it to the PerlMonks community, you may post it here.
</p></dd>
<a name="reviews"></a>
<dt><b>[id://21144]</b></dt><dd><p>
<ul>
<li>Perl related book reviews</li>
<li>Module reviews</li>
</ul>
</p></dd>
<a name="tutorials"></a>
<dt><b>[id://954]</b></dt><dd><p>
This section is an ever-growing online textbook from which you can
learn everything from Perl basics to advanced algorithmic techniques.
</p><p>
Ideally, the [Tutorials] section has a high value-to-noise ratio.
Tutorial articles should be written so as to invite <i>as little discussion as possible</i>.
Therefore, we recommend that, while you <i>can</i> post directly to the [id://954] section,
it's generally better to follow this procedure:
<ol>
<li> Write up your draft tutorial and put it in your scratchpad; broadcast requests for comments in the [id://236794|chatterbox] and elsewhere.<br/> After revising,</li>
<li> Post it as a new [Meditations|Meditation], with "RFC" in the title.<br/>
Later, if it is generally acclaimed to be worthy of [Tutorials], but needs more work first, then make the necessary revisions and</li>
<li> Post the final version as a [Tutorials] node. </li>
</ol>
</p><p>
Also of interest: [id://487572]
</p></dd>
</dl>
<hr/>
<p>
(This FAQlet supercedes [vroom]'s original document, [id://42273])
</p>
<p>
Another view of the same info (more or less) is [id://972].
</p>
<hr/><i>Back to the [PerlMonks FAQ]</i>