CINXE.COM

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">  <html lang="en"> <head id="stdcontainer"> <title> How do I compose an effective node title? </title> <link rel="canonical" href="https://www.perlmonks.org/?node_id=341118" />  <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-341118">   <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%" > Think about Loose Coupling </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 compose an effective node title?</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 Mar 30, 2004 at 22:28 UTC</span> <span class="addlinks">( <a href="?node_id=341118">[id://341118]</a>=<a href="?node_id=17338">sitefaqlet</a>: <a rel="nofollow" href="?displaytype=print;node_id=341118">print</a> <a rel="nofollow" href="?replies=1;displaytype=print;node_id=341118">w/replies</a>, <a href="?node_id=341118;displaytype=xml">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">    <h1>How do I compose an effective node title?</h1>  <p> Before you click submit, ask yourself: <i>Does this post have a good title?</i> </p> <p> When composing node titles, remember their important role in site searching. In particular, keep in mind that the PerlMonks search engine is far more reliant on keywords, and less on context, than a human is when scanning titles. Therefore, titles need not only to be meaningful to humans, but also to have high information value for a keyword search. (Not that you should be appending a list of keywords to your titles, of course!) For example, a human can map "apache" to "webserver" far more efficiently than a search engine can. </p>  <p> Ever since <a href="http://en.wikipedia.org/wiki/Special:Search?search=Eternal%20September">the start of the age</a>, poorly composed node titles (or email subject lines, or Usenet subject lines) have been a persistent problem on the Internet. Poor titles inhibit readers from finding the posts that interest them, and from filtering out those posts that are not of interest. If you want your post to be read by people who care what's written (and don't we all?) choose an effective node title. </p> <p> A node title should concisely convey the subject of the node. If the node is a question asking how to sort in reverse-numeric order, the title ought to make that clear. If the node is a meditation on the merits and pitfalls of using <a href="?node=map">map</a> in void context, the title should make that clear as well. </p> <p> If the node is about betting on basketball games, its title should be prefixed with "<b>[OT] </b>" to indicate that the post is <b>O</b>ff-<b>T</b>opic. </p> <p> Node titles should be crafted with care and thoughtfulness. A reader should be able to read the node title and already formulate an accurate opinion as to the node's content. </p> <p> The following is an example list of bad node titles, along with a description as to what is bad about them. They're not intended to pick on anyone. But read them with a smirk, because I'm sure you've all seen them before and thought, "Argh!": </p> <p> <ul> <li><u>Newbie question</u> or <u>Simple question</u> or <u>Another question</u> or <u>Perl question</u> <br />Such titles convey no information. It's understood that most root posts are questions. The level of the poster's perl expertise and the simplicity of the question are irrelevant. And since this is a Perl-oriented site, saying it's a Perl question is annoyingly redundant. Even titles like <u>Hash question</u>, <u>Array question</u>, or <u>Syntax error</u> are not specific enough to be of any use. The only thing people will get from this is that the poster is a newbie having some trouble with perl syntax. Maybe.<p> <li><u>Help please</u>, or <u>Urgent help needed!</u><br /> Good questions, posted with good titles, will get answers. There is no need to grovel or demand anything in the title. One thing to remember is that PerlMonks is not a professional helpdesk. No one is obliged to answer any questions. <i>The best way to get an answer is to <a href="?node_id=174051">ask the question effectively</a>, and give it a good title.</i> <p> <a name="single_word_titles"></a> <li><u>thanks</u>, or <u>problem</u>, or <u>regex</u><br /> In addition to all the deficiencies discussed above, such titles have the additional problem of consisting of a single word. One-word titles are generally a bad idea. (There are certain sections of the site where exceptions are made - notably, <a href="?node_id=1590">Perl Poetry</a> and <a href="?node_id=1597">Obfuscated code</a> - and, of course, <u>users</u>.) The reason, in a nutshell, is that it impedes title-based site navigation. For more info, see: <ul> <li> discussion <a href="?node_id=387989">Disallowing single-word titles in SOPW</a> <li> discussion <a href="?node_id=419689">Considering nodes for re-titling</a> <li> the bit about titles in faqlet <a href="?node_id=324820">What do Janitors do?</a> </ul> <p> <a name="module_name_titles"></a> <li><u>XML::Simple</u>, <u>CGI.pm</u>, etc.<br /> A module name isn't a question. If you're having problems with a module, give some gist of the problem in the title! For example, "XML::Simple chokes on my input file". This rule applies even in the <a href="?node_id=30794">Module Reviews</a> section, where titles should be of the form "Review: XML::Simple". <p> <li><u>When should I demand a raise?</u><br /> PerlMonks is a Perl-related web site, so posts should always have something to do with <i>something</i> that could be related to perl. However, allowance is made for discussion of topics that may reasonably be considered of interest to most Perl programmers. In such cases, the titles should be prefixed with <b>"[OT] "</b> meaning <b>O</b>ff-<b>T</b>opic. </ul> </p> <h3>Why is it important to compose accurate, concise, and descriptive titles?</h3> <p> There are several reasons, including (but not limited to) the following: </p> <p> <ul> <li>Have you noticed that "Search" box at the top of PerlMonks page? Many people use that before posting questions, to try to research answers for themselves. This "Search" utility searches <b>node titles</b>. If every discussion thread were named "Newbie question", it wouldn't do any good for someone to search for nodes with "deleting hash elements" (e.g.) in their titles. For title searches to work well, titles must be written well. (For the record -- there's a second, more powerful, search utility here at the Monastery, called "<a href="?node_id=3989">Super Search</a>." It can search node titles <em>and/or</em> node content.)<p> <li>Click on <a href="?node_id=3628">Newest Nodes</a>, if you haven't done so lately. (Open it in a separate browser window so as not to interrupt reading this FAQlet.) See how many nodes there are? This is a pretty high-volume website. Wouldn't you like to know ahead of time, without clicking on each and every node title, which nodes might be of interest to you, and which ones you might just want to skip? Effective node titles save everyone time on skimming through the sea of nodes for ones that are of interest or relevance. Imagine if the dictionary contained 35,000 definitions, but in place of the word being defined at the head of each entry, they all started with "Definition".<p> <li>Go look at <a href="?node_id=28877">Nodes To Consider</a> (again, in a separate window, so you can follow along here). Chances are, at any given time there will be at least a couple of nodes being "considered" for title change. This happens when a <a href="?node_id=17645">high-level monk</a> decides that the title of the node in question is so poorly composed that it needs to be changed. Other <a href="?node_id=17645">high-level monks</a> <a href="?node_id=92975">get to cast votes</a> saying if they agree. If there is strong concensus, the site <a href="?node=janitors">janitors</a> are given the task of editing the node's title. They do this for many reasons, including those listed listed above. Do you really want to create all that work for others here, and at the same time draw negative attention to your node because your title just says, "Newbie, help!"? <p> </ul> </p> <a name="replies"></a> <h2>As a general rule, refrain from changing the title of a reply node unless you're actually changing the subject.</h2> <p> ... and in such cases, posting a new root node is generally preferable. (But of course, link back to the original thread if it is relevant.) </p>  <p> If, after careful consideration, you decide that a mid-thread title change is appropriate, please at least retain part of the original title, including the "Re^$x:" part. </p><p> A <em>complete</em> title change may seem reasonable when viewed in the context of the thread, but there are too many other places where titles are displayed <i>outside</i> the thread context (especially <a href="?node=Newest%20Nodes">Newest Nodes</a> and several types of search results) where complete title changes are just annoying. Straining the patience of your fellow monks with such antics is likely to garner you some <a href="?node_id=168266">down-votes</a>. </p><p> Also read this <a href="?node_id=428594">related discussion</a>, and <a href="?node_id=419738">this explanation</a> by <a href="?node=tye">tye</a>. </p> <hr /> <p> For additional reading, please see <a href="?node_id=174051">How do I post a question effectively?</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="341118" ></input></span> <input type="hidden" name="op" value="login" /> <input type="hidden" name="lastnode_id" value="341118" /> <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'><span class='currentdomain'>www</span>.<a class='domainlink' href="http://perlmonks.com/index.pl?node_id=341118">com</a> | <a class='wwwdomainlink' href="http://www.perlmonks.net/index.pl?node_id=341118">www</a>.<a class='domainlink' href="http://perlmonks.net/index.pl?node_id=341118">net</a> | <a class='wwwdomainlink' href="http://www.perlmonks.org/index.pl?node_id=341118">www</a>.<a class='domainlink' href="http://perlmonks.org/index.pl?node_id=341118">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="341118" ></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">admiring</span> the Monastery:</span> (3)<br /><ul class="spacey-list"><li><span class='even-row'><span class='item-000'><span class='user-level-24'><span class='user-832495'><a title="choroba's home node. Level 24. Member of: pmdev" href="?node_id=832495">choroba</a></span></span></span></span></li> <li><span class='odd-row'><span class='item-001'><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='even-row'><span class='item-002'><span class='user-level-1'><span class='user-11155664'><a title="chatterbot's home node. Level 1" href="?node_id=11155664">chatterbot</a></span></span></span></span></li> </ul><span class='update-time'><small>As of 2025-02-26 16:34 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 lovingly hand-crafted by <a href="?node=vroom">Tim Vroom</a>.<br/> PerlMonks was recently assimilated by <a href="http://www.perlfoundation.org">The Perl Foundation</a>. <a href="?node=Offering%20Plate">Donate</a> to TPF!<br /> Marvelous Managed Hosting 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>