Below is the new PerlMonks FAQ, organized hierarchically.

Getting Started with PerlMonks  (Top)

Whether you've just discovered PerlMonks or have recently registered for a user account here, you will find the following information useful.

Also take a gander at our collection of user-contributed how-to's: Understanding and Using PerlMonks.

• The Perl Monks Guide to the Monastery
• Creating an account on PerlMonks
• Choosing a username
• Can I change my username?
• Changing your password
• Retrieving a forgotten username or password
• Logging on to PerlMonks
• How do I log out?
• How do I change my home node?
• How do I change my preferences?
• How do I work with Scratchpads?
• Using the Message Inbox
• Is PM a good place to get answers for homework?
• I need help! Who can help me?
• How can I wipe every trace of myself from PerlMonks?
• Are Raku related posts allowed on PerlMonks?

About PerlMonks  (Top)

• What is PerlMonks?
• Who runs PerlMonks?
• Do I have privacy on PerlMonks?
• I think I'm experiencing a bug/problem with PerlMonks. How do I report it?
• How is the PerlMonks FAQ maintained?
• What are PerlMonks Orders?
• What's New at PerlMonks?
• Site seems slow. Is this normal?
• Is there PerlMonks merchandise I can buy?
• History of PerlMonks
• History of the Perl News section

Advanced PerlMonks Topics  (Top)

• Guide to PerlMonks Acronyms and Abbreviations
• PerlMonks Approved Chatter HTML Tags
• Signatures and Node Templates
• PerlMonks and JavaScript
• PerlMonks-Related Resources on Other Servers
• Why is the PerlMonks page too wide?
• What XML generators are currently available on PerlMonks?
• Where is Perl function foo() documented?
• Is there a site like PerlMonks for Java/PHP/Linux/SQL/etc.?
• Can I get the PerlMonks source code?
• Can I get a copy of all the PerlMonks content?
• How does 'Select Code to Download' Work?
• Why is the "number of write-ups" wrong?
• Why do we allow anonymous posting? Shouldn't we get rid of Anonymous Monk?

PerlMonks Sections  (Top)

(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 jobs.perl.org, not here. (See May I post a job ad?)

These are the available sections of PerlMonks:

• Seekers of Perl Wisdom
• Cool Uses for Perl
• Meditations
• Perl Monks Discussion
• Tutorials
• Obfuscated code
• Perl Poetry
• Perl News

Searching PerlMonks  (Top)

PerlMonks has its own search features, described below. In addition, you should be able to use off-site web search engines such as Google.

• Using the Simple Search
• Using Super Search
• Patterns in PerlMonks Searches

Posting on PerlMonks  (Top)

• I want to ask a question of the Perl Monks; where do I start?
• Where should I post X?
• How do I post a question effectively?
• How do I compose an effective node title?
• Writeup Formatting Tips
• Markup in the Monastery
• Perl Monks Approved HTML tags
• May I post a job ad?
• Why did I get downvoted?
• Why can't I see my post?
• How do I change/delete my post?
• Is there a preview option when updating a node, like there is when creating a new node?
• What do Janitors do?
• How are the Illuminations maintained?
• How does editing work in the Tutorials section?
• How do I create a Poll?
• I think there should be a new Section on PerlMonks for Jobs/Modules/Quizzes/Perl6/Newbies/OffTopic/etc.
• I think code should be automatically syntax highlighted / run through PerlTidy when posted on PerlMonks

Linking on PerlMonks  (Top)

• What shortcuts can I use for linking to other information?
• How do I link to nodes on this site by title?
• How do I link to a node on this site by number?
• There is more than one node with the same name. How do I link to the one that I want?
• How do I link to the Perl documentation?
• How do I link to modules on CPAN?
• How do I link to a Google search?
• How do I link to a book by ISBN?
• Linking to Copyrighted Materials

Messaging on PerlMonks  (Top)

• Using the Message Inbox
• Chatterbox FAQ
• What is the Chatterbox?
• Using the Chatterbox: Public Messaging
• Using the Chatterbox: Private Messaging
• Using the Chatterbox: URLs, Special Characters, and Code
• Using the Chatterbox: Linking
• PerlMonks Approved Chatter HTML Tags
• Other CB Clients

Voting, Reputation, Experience, and Levels  (Top)

• Voting/Experience System
• Levels of Monks
• What is reputation?
• I just became a Novice; Why can't I vote yet?
• How should I spend my votes? -- General Voting Guidelines

Moderation on PerlMonks  (Top)

• What is moderation?
• Who can moderate?
• How do I moderate?
• What nodes should/should not be FrontPaged?

Consideration on PerlMonks  (Top)

• What is consideration?
• Who can consider a node?
• How do I use the power of consideration responsibly?
• How does Nodes to Consider work?
• What is Reaping?

Orders of Monks  (Top)

The groups of users detailed below have undertaken vows of service to the Monastery.

See What are PerlMonks Orders? for more information on user groups, such as how to join one.

There are also a few other user groups that have less important purposes (developers, SiteDocManagers, Site Documentation Clan, editors, pmtesters, holders of unholy power, Breathers of Fire, tinkers, punsters, and pirates).

• cabal
• gods
• pmdev
• power users
• janitors
• QandAEditors
• SiteDocClan
• pedagogues
• pollsters

PerlMonks Nodelets  (Top)

• What are Nodelets?
• About the Approval Nodelet
• About the CGI::param Nodelet
• About the CPAN Nodelet
• About the Cabalists' Nodelet
• About the Chatterbox Nodelet
• About the Daily Best Nodelet
• About the Domain Nodelet
• About the Editors Nodelet
• About the Everything Developer Nodelet
• About the Find Nodes Nodelet
• About the Free Nodelet
• About the Function Nodelet
• About the Information Nodelet
• About the Keyword Nodelet
• About the Leftovers Nodelet
• About the Moderation Nodelet
• About the Monthly Best Nodelet
• About the Node Status Nodelet
• About the Node Navigator Nodelet
• About the Nodelet Nodelet
• About the Other Users Nodelet
• About the Pedagogues Nodelet
• About the Personal Nodelet
• About the Pmdev Nodelet
• About the Sections Nodelet
• About the Settings Nodelet
• About the SiteDocClan Nodelet
• About the Synch Nodelet
• About the Tick Tock Nodelet
• About the Voting Booth Nodelet
• About the Weekly Best Nodelet
• About the XP Nodelet

Where can I find more information on...  (Top)

• PerlMonks-Related Resources on Other Servers
• Installing and Adding to Perl
• Code Editors and Development Environments
• Perl Reference Materials: Books
• Perl Reference Materials: Periodicals
• Perl Reference Materials: Tutorials
• Perl People and Organizations
• Miscellaneous Off-site Resources