<?xml version="1.0" encoding="windows-1252"?>
<node id="972" title="The Perl Monks Guide to the Monastery" created="1999-11-11 22:35:51" updated="2005-08-15 07:16:25">
<type id="17338">
sitefaqlet</type>
<author id="17342">
SiteDocClan</author>
<data>
<field name="doctext">
&lt;!--
2004-09-23 [jdporter] Removed Craft and the FAQ thing at the end. Added PMD, Snippets, Q&amp;A, News, Reviews, NN, Offering Plate. Rearranged to the same order as in the "menu bar".  However, even though the order is the now the same as on the menu bar, the titles are drawn directly from the nodes.  The most egregious case is "Q&amp;A".  Can we rely on the novice to connect the name of the section listed here with the link in the menu bar?
2005-03-14 [ysth] added recently active threads; reordered the comment listing the sections to how the menu bar is now
2006-06-13 [jdporter] re-workd to follow the organization used in the three nodelets, with some minor adjustments.
--&gt;

&lt;h1&gt;The Perl Monks Guide to the Monastery&lt;/h1&gt;

&lt;p&gt;
Welcome to PerlMonks, the Monastery of Perl.
We hope your stay is long and enjoyable.
You are probably wondering what this is all about.
Hopefully this page will answer some of those questions.
&lt;/p&gt;

&lt;!-- &lt;p&gt;&lt;i&gt;What is this all about, exactly?&lt;/i&gt;&lt;/p&gt; --&gt;

&lt;p&gt;
PerlMonks is many things to many people, including:
&lt;ul&gt;
&lt;li&gt;A medium for making Perl as non-intimidating to learn and as easy to use as possible&lt;/li&gt;
&lt;li&gt;A place for Perl programmers (such as you) to improve your skills and share your expertise&lt;/li&gt;
&lt;li&gt;A community which allows everyone to grow and learn from everyone else&lt;/li&gt;
&lt;/ul&gt;
&lt;/p&gt;


&lt;!-- According to the "menu bar":

 131	The Monastery Gates
 3989	Super Search

 479	Seekers of Perl Wisdom
 480	Meditations
 1040	Perl Monks Discussion			PerlMonks Discussion
 1967	Snippets Section			Snippets

 1597	Obfuscated code				Obfuscation
 21144	Reviews
 1044	Cool Uses For Perl
 23771	Perl News
 1843	Categorized Questions and Answers	Q&amp;A
 954	Tutorials

 1747	Code Catacombs				Code
 1590	Perl Poetry				Poetry
 397425 Recently Active Threads
 3628	Newest Nodes
 71130	Offering Plate

--&gt;

&lt;h3&gt;Finding Your Way Around&lt;/h3&gt;

&lt;p&gt;
First, the Monastery has some repositories of information useful to the
Perl Monk, designed to help you get the most out of your experience here.
Second, we have a number of areas, called &lt;i&gt;sections&lt;/i&gt;, where people can
post code, questions, and responses (known generically as "nodes") in a
threaded forum-like format.
As an adjunct to those sections, there are various views into the great
node repository which assist you in finding nodes of interest to you
&amp;mdash; recently posted nodes, say, or meditations posted by a certain monk.
Finally, we have an assortment of pages not easily classifiable elsewhere.
&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt; &lt;a href="#info"&gt; &lt;b&gt;Information&lt;/b&gt; &lt;/a&gt;&lt;/li&gt;
&lt;li&gt; &lt;a href="#sections"&gt; &lt;b&gt;Sections&lt;/b&gt; &lt;/a&gt;&lt;/li&gt;
&lt;li&gt; &lt;a href="#find"&gt; &lt;b&gt;Find Interesting Nodes&lt;/b&gt; &lt;/a&gt;&lt;/li&gt;
&lt;li&gt; &lt;a href="#misc"&gt; &lt;b&gt;Additional Miscellany&lt;/b&gt; &lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;
This is just an overview. Exhaustive documentation on every aspect
of the PerlMonks web site can be found in the [PerlMonks FAQ].
&lt;/p&gt;
&lt;hr/&gt;

&lt;a name="info"&gt;&lt;/a&gt;
&lt;h4&gt;Information&lt;/h4&gt;
[pmdev://1053|(based on the Information nodelet)|]
&lt;blockquote&gt;

    &lt;p&gt;
    &lt;b&gt;The [PerlMonks FAQ]&lt;/b&gt; -
    Your one-stop shop for Nearly Everything You Ever
    Wanted To Know About PerlMonks.
    Maintained by the [SiteDocClan].
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://545862]&lt;/b&gt; -
    What's New at PerlMonks.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://5938]&lt;/b&gt; -
    Many newcomers are confused by this aspect of
    PerlMonks. This should clear things up.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://382|Perl FAQ]&lt;/b&gt; and &lt;b&gt;[id://148]&lt;/b&gt; -
    Our local copy of the standard Perl documentation set,
    for your convenience. Note, however, that the content is
    not being maintained and is now a couple versions old.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://483101]&lt;/b&gt; -
    &lt;!-- replaces the obsolete [Outside Links]. --&gt;
    Various other sites which Perl Monks might find useful.&lt;br/&gt;
    See especially [id://579676].
    &lt;/p&gt;

&lt;/blockquote&gt;

&lt;a name="sections"&gt;&lt;/a&gt;
&lt;h4&gt;Sections&lt;/h4&gt;
[pmdev://1052|(based on the Sections nodelet)|]
&lt;blockquote&gt;

    &lt;p&gt;
    &lt;b&gt;[id://479]&lt;/b&gt; -
    The place you can go when you have got a question on how to
    do something or are unsure why something just isn't working.
    Then other Perl Monks can offer you their wisdom and suggestions.  
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://480]&lt;/b&gt; -
    Have you found out something amazing about Perl which you
    just need to share with everyone? 
    Have you had a Perl epiphany, or found something in Perl 
    which just blows your mind?
    This is the place for those neat little tricks and amazing
    discoveries.  
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1040|PerlMonks Discussion]&lt;/b&gt; - 
    For discussions relating specifically to this web site, and
    how things work around here.  For example, if you think the
    Monastery could be improved in some particular way, raise
    it for discussion here.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1843]&lt;/b&gt; - 
    Our own ever-growing compendium of "frequently asked" 
    Perl-related questions and their answers.
    If you're faced with a problem and you think it might be common
    enough that others have already solved it, then
    check here before you go posting to [id://479].
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://954]&lt;/b&gt; - An ever-growing online textbook from which
    you can learn the basics of Perl or some nifty stuff
    you haven't tried before.
    This area is managed by the [Pedagogues].
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1597]&lt;/b&gt; - Got code which would take a Perl 
    grand master to understand?
    Post it here so we can stare at it in awe.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1590]&lt;/b&gt; - The name pretty much says it all.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1044]&lt;/b&gt; - This is the place to share or show off
    your work of Perl prose. Posts can be of any size &amp;mdash;
    from the brilliant one-liner to the work-horse module to the
    full-blown application program. 
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://21144]&lt;/b&gt; -
    If you are shopping around for the Perl module
    or book which is just right for your needs,
    read these reviews &amp;mdash; written by your fellow
    Perl Monks &amp;mdash; to help you make an informed decision.
    &lt;br/&gt;
    Conversely, if you have used a module or read a book,
    and you think other Perl Monks might benefit from your
    experiences, please share them here by writing a review!
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://23771]&lt;/b&gt; - 
    Timely news and announcements for, and from, the Perl Monks, and from the wider Perl community.
    &lt;/p&gt;

&lt;/blockquote&gt;

&lt;a name="find"&gt;&lt;/a&gt;
&lt;h4&gt;Find Interesting Nodes&lt;/h4&gt;
[pmdev://1054|(based on the Find Nodes nodelet)|]
&lt;blockquote&gt;

    &lt;p&gt;
    &lt;b&gt;[The Monastery Gates]&lt;/b&gt; -
    The "default" page of the web site, it shows recent nodes
    from all sections which have been deemed most worthy of
    public exposure &amp;mdash; the "face" of PerlMonks.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://3989]&lt;/b&gt; -
    Full-text and title searches, with additional filtering
    by section, age, author, and many other criteria.
    &lt;/p&gt;

    &lt;!--&lt;p&gt;[Perl Monks User Search|List Nodes By Users]&lt;/p&gt;--&gt;

    &lt;p&gt;
    &lt;b&gt;[id://3628]&lt;/b&gt; -
    An up-to-the minute listing of all the nodes which
    were created since "the last time you checked".
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://16902]&lt;/b&gt; -
    Similar to [id://3628], a listing of the user homenodes which
    have been modified since "the last time you checked".
    (Note that only changes designated by their authors as
    "significant" will register in this list.)
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://397425]&lt;/b&gt; -
    A threaded view of the Monastery's active content.
    It's like [Newest Nodes] on steroids.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://328478]&lt;/b&gt; -
    A random selection of 50 of the top 2000 nodes of all time,
    as ranked by node [id://18538|reputation]. 
    The selection is re-sampled daily.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://9066]&lt;/b&gt; -
    The top 10 nodes of the Day, the Week, and the
    Month, and the top 20 nodes of the Year.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://9488]&lt;/b&gt; -
    The bottom 10 nodes of the Day, the Week, and the
    Month, and the bottom 20 nodes of the Year.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://3559]&lt;/b&gt; -
    "Saints" here is more figurative, or honorary;
    this is a list of Monks who have at least 3000 
    [id://5938|experience points], which technically
    makes them [id://504005], not [id://244022].
    &lt;/p&gt;

&lt;/blockquote&gt;

&lt;a name="misc"&gt;&lt;/a&gt;
&lt;h4&gt;Additional Miscellany&lt;/h4&gt;
[pmdev://1055|(based on the Leftovers nodelet)|]
&lt;blockquote&gt;

    &lt;p&gt;
    &lt;b&gt;[The St. Larry Wall Shrine]&lt;/b&gt; - 
    A neat compendium of articles by and about the creator of Perl.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://71130]&lt;/b&gt; -
    If you find this place to be of value, you can show
    your appreciation by helping defray the costs of
    keeping the site up and running.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[Awards]&lt;/b&gt; - 
    Accolades and other noteworthy public mentions of
    PerlMonks.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;p&gt;
    &lt;b&gt;[id://29195]&lt;/b&gt; -
    Yes, you can actually buy Perl and PerlMonks-related gear...
    such as a t-shirt with the famous [id://45213] obfu on it!
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1967|Snippets] (deprecated)&lt;/b&gt; - 
    This was a place to show off clever, useful, &lt;i&gt;short&lt;/i&gt; bits of code, such as one-liners.
    As such, it was redundant with [Cool Uses For Perl],
    but it still makes an interesting read.
    &lt;/p&gt;

    &lt;p&gt;
    &lt;b&gt;[id://1747] (deprecated)&lt;/b&gt; -
    This was intended as a place to post full-blown programs and modules.
    As such, it was redundant with [Cool Uses For Perl],
    but much interesting and useful code can still be found there.
    &lt;/p&gt;

    &lt;b&gt;[id://481|Craft] (deprecated)&lt;/b&gt; -
    This was a place for perlsmiths to showcase their code. 
    As such, it was redundant with [Cool Uses For Perl], 
    but it still makes an interesting read.
    &lt;/p&gt;

&lt;!-- someone should add notes to explain how these are used: --&gt;

    &lt;!-- &lt;p&gt;&lt;b&gt;[Quests]&lt;/b&gt;&lt;/p&gt; --&gt;

    &lt;!-- &lt;p&gt;&lt;b&gt;[Editor Requests]&lt;/b&gt;&lt;/p&gt; --&gt;

&lt;/blockquote&gt;

&lt;hr/&gt;
&lt;!-- end of new layout --&gt;

&lt;p&gt;
Please read the &lt;b&gt;[id://483077|Posting on PerlMonks]&lt;/b&gt;
section of the [PerlMonks FAQ] before posting.
You won't regret it!
&lt;/p&gt;

&lt;hr/&gt;&lt;i&gt;Back to the [PerlMonks FAQ]&lt;/i&gt;
</field>
</data>
</node>
