CINXE.COM

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">  <html lang="en"> <head id="stdcontainer"> <title> How do I post a question effectively? </title> <link rel="canonical" href="https://www.perlmonks.org/?node_id=174051" />  <script language="javascript" type="text/javascript" src="?node=list%20replies%20toggle%20javascript" integrity="sha384-6jdBZxT7udN82vOTryPaLwqMohSfDF3HXv3M32KAZ7dOREMdAkYh9ZhoaKCgCXcr" crossorigin="anonymous"></script> <link rel="stylesheet" href="/css/common.css" type="text/css" /> <link rel="stylesheet" href="?node_id=204962" type="text/css" />   <link rel="icon" href="/favicon.ico" /> </head> <body id="id-174051">   <table id="monkbar" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr class="bannerrow"> <td align="left" width="100%"> <a href="http://pair.com"> <img src="//promote.pair.com/i/pair-banner-current.gif" height = "60" width = "468" alt = "Beefy Boxes and Bandwidth Generously Provided by pair Networks" /> </a> </td> <td rowspan="2" align="right" valign="bottom">  </td> </tr> <tr class="monkquip"> <td class="monkquip" valign="bottom" width="100%" > Problems? Is your data what you think it is? </td> </tr> <tr class="titlebar"> <td class="titlebar"> <form method="get" action="?" enctype="application/x-www-form-urlencoded" >   <input type="text" name="node" id="search_text" size="20" maxlength="300" /> <input class="titlebar" type="submit" value="Search" /> </form> </td> <td class="titlebar" id="mb2001titlebar" align="right" > <a class="titlebar" href="?">PerlMonks</a>   </td> </tr> </table>   <table width="98%" align="center" id="titlebar-top"> <tbody> <tr> <td valign="middle" class="titlechooser">  <h3 class="other">How do I post a question effectively?</h3> <span class="attribution">by <a href="?node_id=17342">SiteDocClan</a> <span class="attribution-title">(Initiate)</span> </span>  </td> <td valign="top" align="right" class="monktitlebar">  <ul class="topnavmenu inline-list"> <li><a href="?node_id=109">Log in</a></li><li><a href="?node_id=101">Create a new user</a></li> <li><a href="?">The Monastery Gates</a></li> <li><a href="?node=Seekers%20of%20Perl%20Wisdom">Seekers of Perl Wisdom</a></li> <li><a href="?node=Meditations">Meditations</a></li> <li><a href="?node=Cool%20Uses%20for%20Perl">Cool Uses For Perl</a></li> <li><a href="?node=Obfuscated%20Code">Obfuscation</a></li> <li><a href="?node=Tutorials">Tutorials</a></li> <li><a href="?node=Perl%20Poetry">Poetry</a></li> <li><a href="?node=Illuminations">Illuminations</a></li> <li><a href="?node=Reviews">Reviews</a></li> <li><a href="?node=Perl%20News">Perl News</a></li> <li><a href="?node=Recently%20Active%20Threads">Recent Threads</a></li> <li><a href="?node=Newest%20Nodes">Newest Nodes</a></li> <li><a href="?node=Super%20Search">Super Search</a></li> <li><a href="?node=Perl%20Monks%20Discussion">PerlMonks Discussion</a></li> <li><a href="?node=Tidings">What's New</a></li> </ul>   </td> </tr> </tbody> </table> <table width="98%" align="center" id="titlebar-bottom"> <tbody> <tr> <td valign="middle" class="titlechooser">  <span class="attribution">on Jun 12, 2002 at 22:32 UTC</span> <span class="addlinks">( <a href="?node_id=174051">[id://174051]</a>=<a href="?node_id=17338">sitefaqlet</a>: <a rel="nofollow" href="?displaytype=print;node_id=174051">print</a> <a rel="nofollow" href="?node_id=174051;replies=1;displaytype=print">w/replies</a>, <a href="?displaytype=xml;node_id=174051">xml</a> )</span>  </td> <td valign="middle" align="right" class="monktitlebar"> <a href="?node=PerlMonks%20FAQ">Need Help??</a> </td> </tr> </tbody> </table>   <center> <table width="98%"> <tr> <td width="80%" valign="top" class="main_content">   <a name="top"></a> <p>This document tries <b>to help you get help</b>. These are not "<i>rules for the sake of rules</i>" but, rather, guidelines to help you help us to help you.</p> <h2>Here's the short version:</h2> <p>If you want to get good answers: <big> <b>Paste <em>actual</em> code that <em>reproduces</em> the problem between <tt class='inlinecode'><code></tt> and <tt class='inlinecode'></code></tt> tags . State exactly what the problem is. Be precise about the correct behavior / desired output.</b></big> Additional background about what you are trying to do and what you have tried also helps. For example:</p> <table width="50%" border="1"><tr><td> <pre class="code"><div class='codeblock'><tt class='codetext'><code> use strict; use warnings; ... </code> <p>gives me this error message / faulty output:</p> <code> ... </code> <p>I'm trying to ...</p> <p>I also tried ...</p> </tt></div><div class='embed-code-dl'><a href="?node_id=174051;abspart=1;part=3;displaytype=displaycode">[download]</a></div></pre> </td></tr></table> <p>Quick Links:</p> <ul><li>What if I <a href="#minimal">don't have code</a> ...have too much code, or don't understand an error message?</li> <li>How should I <a href="#title">name my question?</a>.</li> <li>Can I get help <a href="#no_question">without posting a question?</a></li> <li><a href="#preview">Preview, preview, PREVIEW!</a></li> </ul> <p>Now, if you're wondering "Where to ask?" <a href="#where">the answer is here.</a></p>  <p><b>BUT</b> please come back soon, and read the rest of this.</p> <h2>Here's more extensive advice:</h2> <p><b>First and foremost, think through your question.</b></p> <ul><li>Can you explain it clearly to yourself?</li> <li>Can you explain it to others?</li> <li>What example data would help them understand the issue?</li> <li>What's not happening that you think should happen, or happening that you think should not (or don't understand)?</li> </ul> <p><b>Write it down -- preferably in your editor on your machine.</b></p> <p>Look away for a moment; perhaps mull the question over some more.</p> <p>Edit for clarity and precision (<i>leet-speek iz rong on both cnts!</i>). Spelling and grammar count (but we try hard to understand if English is not your native tongue).</p> <p>Repeat as necessary. It's often said and often true that explaining a problem <a href="http://headrush.typepad.com/creating_passionate_users/2005/01/rubberducking_a.html">to a rubber ducky</a> or <a href="?node_id=376075#item_did_you_talk_to_the_bear?">to a teddy bear</a> will show you a solution.</p> <p><b>Show us that you've made an effort.</b></p> <ul><li>Show your code (at least the problematic snippet)</li> <li>Explain in detail what you get (include sample output, error messages and warnings, for example).</li> <li>Tell us how your output means your script isn't working.</li> </ul> <p>If you do, it's likely someone will provide pointers in the right direction.</p> <h2><b>Now you're getting close to a good question.</b></h2> <a name="minimal"></a><h4>Code, no code and errors</h4> <p>But before you post it, take another step. Include (inside <b><code>...</code></b> or <b><c>...</c></b> tags) a <b>minimal</b> script that reproduces your problem and sample data (input). <a name="nocode"></a> Of course, if your problem is that you can't get the script to compile, despite your best efforts -- perhaps because the error message doesn't make sense to you -- go ahead and post the section where strict tells you that you have an error (and, of course, the error message, verbatim) It is ok to ask for help if you can't figure out why something won't compile. But let that be your question and save the "my script won't do X" question for later."</p> <p><b>Use strict and warnings. <font color="red">Failure to use strict and warnings is a red flag</font></b>; it tells us you didn't use the available tools ("aka, make an effort").<br /> On the other hand, using these pragmas may show you how to solve your problem before you post. For example, they'll catch variables where you make a typo between assignment and use. Failure to use them is like ice-climbing without a safety line.</p> <p><b>Again, use code tags</b> without fail or the Monks' outrage may lead them to conclude, prayerfully, of course, that you need penance. In fact, failure to use at least minimal markup will almost certainly persuade some of the Reverend Brothers and Sisters to point you to the sackcloth and ashes in the third sub-dungeon. ( See <a href="?node_id=674668">Markup in the Monastery</a> for quick reference or <a href="?node=Perl%20Monks%20Approved%20HTML%20tags">Perl Monks Approved HTML tags</a> for an exhaustive list of what's allowed.) And be sure to close your tags; the special dialect of html used here is unforgiving about failure to close some tags.</p> <a name="preview"></a><h4>Preview.</h4> <p>See if what the preview screen shows looks like what you intended. And if it doesn't, fix your markup, and preview again. ONLY when your note "looks right" should the "Create" button tempt you.</p> <a name="title"></a><h4>Select an informative title.</h4> <p> "Need help ASAP" doesn't cut it. Neither does the name of any Perl function.<br /> For example, if you're having problems dereferencing an array in a hash, <a href="?node=SoPW">SOPW</a> ("Seekers of Perl Wisdom") won't accept a one word title like "%hashref"; %hashref problems" isn't fully descriptive; but "Why doesn't this deref the @arrays in my %hasref?" is probably OK.</p> <a name="no_question"></a> <h3><i>OK, but can I get help without posting a question?</i></h3> <p>Ah, I'm glad you asked.</p> <p>Laziness is one of the virtues admired by Perl programmers -- in themselves or when demonstrated with competence and verve! It is not admired when demonstrated by a Seeker of Perl Wisdom who is too lazy to adhere to the hints above; who posts ambiguous questions; who fails to read the docs (see <tt class='inlinecode'>perldoc perldoc</tt> for an overview of the knowledge that's at your fingertips; or who inconveniences thousands of electrons to ask redundant questions.</p> <h3><i>But I never asked that question before!</i></h3> <p>No, but surely you don't think you're the first to come to the mountaintop seeking that wisdom, do you?</p> <p><a href="?node=Super_Search">Super_Search</a> is your friend. Use it! Or <a href="http://www.google.com/advanced_search?hl=en&as_sitesearch=www.perlmonks.org">Google's advanced search against PerlMonks</a>. Big G is quite good at finding nodes here that will help you, if you ask with reasonable search terms.</p> <h3><i>But I'm new at this; I don't know what search terms to use!</i></h3> <p>Ah, that plaint is sometimes justified, but have you read the manual <a href="?node=How%20to%20RTFM">How to RTFM</a>? Did you look at the plethora of information available via <tt class='inlinecode'>perldoc</tt> or at <a href="?node=%20perldoc.perl.org"> perldoc.perl.org</a>? The <a href="?node=Tutorials">Tutorials</a> may also speed your search for enlightenment.</p> <h2>And a few added points:</h2> <ul> <li>Log in before you post unless you want it to be anonymous (and remember that that anonymonk can't update a node nor <a href="?node_id=786932">get notifications of replies</a>).</li> <li>Don't ever wipe the original content of any node you've written, even if you've solved your problem; you're clarifying your issue; or you realize you just made a "D'oh!" Mark the changed/new content with the word "<b>Update</b>." Don't delete! Doing so is likely to make replies you've received unintelligble to future readers. Use <strike> ... </strike> if you must.</li> <li>This is <b>Perl</b>Monks. Stay on topic. This is not the place to ask about bugs in your javascript (or the other 'j' language) nor how to learn write a formula in a spreadsheet, even though there are many Monks knowledgeable in such disciplines.</li> <li>Be patient. And don't tout your node in the CB.</li> <li>Don't post real email addresses, usernames, or passwords</li> <li>Own up to homework. (We may help with homework when you show some effort, but you're not learning anything and we're not helping if we do it for you.)</li> <li>Understand that the Monastery is NOT a code-machine. Don't ask for a handrolled script to suit your needs. That costs $$$$.</li> <li>RTFM -- the various FAQs, guidance and tutorials on our standards, as well as those on Perl.</li> </ul> <a name="where"></a> <h3><i>But all I wanted to know is "where to post my question?"</i></h3> <p>There's a form at the bottom of the <a href="?node=Seekers%20of%20Perl%20Wisdom">Seekers of Perl Wisdom</a> page (but first, please go back to the <a href="#top">top</a> and actually read the suggestions).</p> <h3><i>Wow! How can I thank you enough?</i></h3> <p>Adhere to these suggestions... and pass them on to others.</p> <h1>For Further Reading</h1> <p> For a much more comprehensive treatment of the subject, check out <a href="http://www.mikeash.com/getting_answers.html#guide_begin">Getting Answers</a> by Mike Ash.  </p> <h4>But please keep in mind -- that site is not related to PerlMonks, and <i>is not a resource for people seeking Perl help</i> (nor any other kind of help, for that matter).</h4> <hr /> <h3>Historical note:</h3> <p> This node originally contained a copy of <a href="?node_id=172086">this excellent tutorial</a> posted by <a href="?node=jeffa">jeffa</a> in 2002. In 2009, it was re-written from scratch via community collaboration; see <a href="?node_id=743806">RFC - How to ask...</a>. </p> <hr /><i>Back to <a href="?node=PerlMonks%20FAQ">PerlMonks FAQ</a></i>   </td>  <td width="20%" valign="top" align="right" class="nodelets">  <table class='nodelet_container' id='nodelet_container'>  <tbody class="nodelet" id="Log_In"> <tr><th class="nodelet_head"> <span class="title">Log In</span><a href="?node=About The Log In Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <form method="post" action="?" enctype="multipart/form-data" name="login"> <span><input type="hidden" name="node_id" value="174051" ></input></span> <input type="hidden" name="op" value="login" /> <input type="hidden" name="lastnode_id" value="174051" /> <table border="0"><tr><td> Username:</td><td> <input type="text" name="user" size="10" maxlength="34" /> </td></tr><tr><td> Password:</td><td> <input type="password" name="passwd" size="10" maxlength="10" /> </td></tr></table> <label><input type="checkbox" name="expires" value="+10y" />remember me</label> <input type="submit" name="login" value="Login" /> <br /> <a href="?node_id=2513">What's my password?</a> <br /> <a href="?node_id=101">Create A New User</a> </form> </td></tr> </tbody>  <tbody class="nodelet" id="Domain_Nodelet"> <tr><th class="nodelet_head"> <span class="title">Domain Nodelet</span><a href="?node=About The Domain Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <p class='domain_link' align='center'><a class='wwwdomainlink' href="http://www.perlmonks.com/index.pl?node_id=174051">www</a>.<a class='domainlink' href="http://perlmonks.com/index.pl?node_id=174051">com</a> | <a class='wwwdomainlink' href="http://www.perlmonks.net/index.pl?node_id=174051">www</a>.<a class='domainlink' href="http://perlmonks.net/index.pl?node_id=174051">net</a> | <span class='currentdomain'>www</span>.<a class='domainlink' href="http://perlmonks.org/index.pl?node_id=174051">org</a></p> </td></tr> </tbody>  <tbody class="nodelet" id="Chatterbox"> <tr><th class="nodelet_head"> <span class="title">Chatterbox</span><a href="?node=About The Chatterbox Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <form method="get" action="?" enctype="multipart/form-data"> <span><input type="hidden" name="node_id" value="174051" ></input></span><i class="cb_quiet">and all is quiet...</i><br /> <input type="submit" name="foo" value="Refresh" /> </form> <i><br /> <a href="?node=ChatterBox%20FAQ">How do I use this?</a> • <a href="?node=last%20hour%20of%20cb">Last hour</a> • <a href="?node_id=20842">Other CB clients</a></i> </td></tr> </tbody>  <tbody class="nodelet" id="Other_Users"> <tr><th class="nodelet_head"> <span class="title">Other Users</span><a href="?node=About The Other Users Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <span class="other-users-text">Others <span class="other-users-blurb">taking refuge in</span> the Monastery:</span> (2)<br /><ul class="spacey-list"><li><span class='even-row'><span class='item-000'><span class='user-level-20'><span class='user-200365'><a title="Tux's home node. Level 20" href="?node_id=200365">Tux</a></span></span></span></span></li> <li><span class='odd-row'><span class='item-001'><span class='user-level-1'><span class='user-11155664'><a href="?node_id=11155664" title="chatterbot's home node. Level 1">chatterbot</a></span></span></span></span></li> </ul><span class='update-time'><small>As of 2025-02-26 20:39 GMT</small></span> </td></tr> </tbody>  <tbody class="nodelet" id="Sections"> <tr><th class="nodelet_head"> <span class="title">Sections</span><a href="?node=About The Sections Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <ul class="spacey-list"> <li><a href="?node=Seekers%20of%20Perl%20Wisdom">Seekers of Perl Wisdom</a></li> <li><a href="?node=Cool%20Uses%20for%20Perl">Cool Uses for Perl</a></li> <li><a href="?node=Meditations">Meditations</a></li> <li><a href="?node=Perl%20Monks%20Discussion">PerlMonks Discussion</a></li> <li><a href="?node=Categorized%20Questions%20and%20Answers">Categorized Q&A</a></li> <li><a href="?node=Tutorials">Tutorials</a></li> <li><a href="?node=Obfuscated%20Code">Obfuscated Code</a></li> <li><a href="?node=Perl%20Poetry">Perl Poetry</a></li> <li><a href="?node=Perl%20News">Perl News</a></li> <li><a href="?node_id=483086">about</a></li> </ul>  </td></tr> </tbody>  <tbody class="nodelet" id="Information"> <tr><th class="nodelet_head"> <span class="title">Information</span><a href="?node=About The Information Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <ul class="spacey-list"> <li><a href="?node=PerlMonks%20FAQ">PerlMonks FAQ</a></li> <li><a href="?node=the%20Perl%20Monks%20guide%20to%20the%20Monastery">Guide to the Monastery</a></li> <li><a href="?node=Tidings">What's New at PerlMonks</a></li> <li><a href="?node=Voting%2FExperience%20System">Voting/Experience System</a></li> <li><a href="?node=Tutorials">Tutorials</a></li> <li><a href="?node=Reviews">Reviews</a></li> <li><a href="?node=Library">Library</a></li> <li><a href="?node=perlman%3Aperlfaq">Perl FAQs</a></li> <li><a href="?node=Where%20can%20I%20find%20more%20information%20on...">Other Info Sources</a></li> </ul>  </td></tr> </tbody>  <tbody class="nodelet" id="Find_Nodes"> <tr><th class="nodelet_head"> <span class="title">Find Nodes</span><a href="?node=About The Find Nodes Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <ul class="spacey-list"> <li><a href="?node_id=6364;user=961">Nodes You Wrote</a></li> <li><a href="?node=My%20Watched%20Nodes">My Watched Nodes</a></li> <li><a href="?node=Super%20Search">Super Search</a></li> <li><a href="?node=Perl%20Monks%20User%20Search">List Nodes By Users</a></li> <li><a href="?node=Newest%20Nodes">Newest Nodes</a></li> <li><a href="?node=Recently%20Active%20Threads">Recently Active Threads</a></li> <li><a href="?node=Selected%20Best%20Nodes">Selected Best Nodes</a></li> <li><a href="?node=Best%20Nodes">Best Nodes</a></li> <li><a href="?node=Worst%20Nodes">Worst Nodes</a></li> <li><a href="?node=Saints%20in%20our%20Book">Saints in our Book</a></li> <li><a href="?op=randomnode">Random Node</a></li> </ul>  </td></tr> </tbody>  <tbody class="nodelet" id="Leftovers"> <tr><th class="nodelet_head"> <span class="title">Leftovers</span><a href="?node=About The Leftovers Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <ul class="spacey-list" id="user"></ul> <ul class="spacey-list" id="internal"> <li><a href="?node=The%20St.%20Larry%20Wall%20Shrine">The St. Larry Wall Shrine</a></li> <li><a href="?node=Offering%20Plate">Offering Plate</a></li> <li><a href="?node=Awards">Awards</a></li> <li><a href="?node=Quests">Quests</a></li> </ul> <ul class="spacey-list" id="external"> <li><a href="http://www.perl.org/">Perl</a></li> <li><a href="http://blogs.perl.org/">Perl Blogs</a></li> <li><a href="http://perl.com/">Perl.com</a></li> <li><a href="https://perl.theplanetarium.org/">Planet Perl</a></li> <li><a href="http://perlweekly.com/">Perl Weekly</a></li> <li><a href="http://jobs.perl.org/">Perl Jobs</a></li> <li><a href="http://www.pm.org/">Perl Mongers</a></li> <li><a href="http://perldoc.perl.org/">Perl documentation</a></li> <li><a href="https://metacpan.org/">MetaCPAN</a></li> <li><a href="http://cpan.perl.org/">CPAN</a></li> <li><a href="https://raku.org/">Raku</a></li> </ul>  </td></tr> </tbody>  <tbody class="nodelet" id="Voting_Booth"> <tr><th class="nodelet_head"> <span class="title">Voting Booth</span><a href="?node=About The Voting Booth Nodelet" class="nodelethead-annot"><sup>?</sup></a> </th></tr> <tr><td class="nodelet_body"> <p>No recent polls found<br /> </td></tr> </tbody> </table>  </td>  </tr> </table> </center>  <br /> <br /> <div id="footer"> PerlMonks parthenogenetically spawned by <a href="?node=vroom">Tim Vroom</a>.<br/> PerlMonks went on a couple dates, and then decided to shack up with <a href="http://www.perlfoundation.org">The Perl Foundation</a>. <a href="?node=Offering%20Plate">Donate</a> to TPF!<br /> Speedy Servers and Bandwidth Generously Provided by <a href="http://promote.pair.com/direct.pl?perlmonks.org"> pair Networks</a> <br/>Built with the <a href="http://perl.org">Perl programming language</a>. </div>  </body> </html>