How To Ask Questions The Smart Way (2024)

How To Ask Questions The Smart Way

Eric Steven Raymond

Thyrsus Enterprises


<esr@thyrsus.com>

Rick Moen


<respond-auto@linuxmafia.com>

Copyright © 2001,2006,2014 Eric S. Raymond, Rick Moen

Revision History
Revision 3.1021 May 2014esr
New section on Stack Overflow.
Revision 3.923 Apr 2013esr
URL fixes.
Revision 3.819 Jun 2012esr
URL fix.
Revision 3.706 Dec 2010esr
Helpful hints for ESL speakers.
Revision 3.702 Nov 2010esr
Several translations have disappeared.
Revision 3.619 Mar 2008esr
Minor update and new links.
Revision 3.52 Jan 2008esr
Typo fix and some translation links.
Revision 3.424 Mar 2007esr
New section, "When asking about code".
Revision 3.329 Sep 2006esr
Folded in a good suggestion from Kai Niggemann.
Revision 3.210 Jan 2006esr
Folded in edits from Rick Moen.
Revision 3.128 Oct 2004esr
Document 'Google is your friend!'
Revision 3.02 Feb 2004esr
Major addition of stuff about proper etiquette on Web forums.

Table of Contents

Translations
Disclaimer
Introduction
Before You Ask
When You Ask
Choose your forum carefully
Stack Overflow
Web and IRC forums
As a second step, use project mailing lists
Use meaningful, specific subject headers
Make it easy to reply
Write in clear, grammatical, correctly-spelled language
Send questions in accessible, standard formats
Be precise and informative about your problem
Volume is not precision
Don't rush to claim that you have found a bug
Grovelling is not a substitute for doing your homework
Describe the problem's symptoms, not your guesses
Describe your problem's symptoms in chronological order
Describe the goal, not the step
Don't ask people to reply by private e-mail
Be explicit about your question
When asking about code
Don't post homework questions
Prune pointless queries
Don't flag your question as “Urgent”, even if it is for you
Courtesy never hurts, and sometimes helps
Follow up with a brief note on the solution
How To Interpret Answers
RTFM and STFW: How To Tell You've Seriously Screwed Up
If you don't understand...
Dealing with rudeness
On Not Reacting Like A Loser
Questions Not To Ask
Good and Bad Questions
If You Can't Get An Answer
How To Answer Questions in a Helpful Way
Related Resources
Acknowledgements

Translations

Translations:Brazilo-PortugueseChinese (Traditional)CzechDutchEstonianFrenchGeorgianGermanGreekHindiHungarianIndonesionJapaneseLithuanianPolishPortugueseRussianSpanishUkrainianUzbekIf you want to copy, mirror, translate, or excerpt this document,please see my copying policy.

Disclaimer

Many project websites link to this document in their sections onhow to get help. That's fine, it's the use we intended — but ifyou are a webmaster creating such a link for your project page, pleasedisplay prominently near the link notice that we are not ahelp desk for your project!

We have learned the hard way that without such a notice, we willrepeatedly be pestered by idiots who think having published thisdocument makes it our job to solve all the world's technicalproblems.

If you're reading this document because you need help, and youwalk away with the impression you can get it directly from the authorsof this document, you are one of the idiots weare talking about. Don't ask us questions. We'll justignore you. We are here to show you how to get help from people whoactually know about the software or hardware you're dealing with, but99.9% of the time that will not be us. Unless you know forcertain that one of the authors is an expert onwhat you're dealing with, leave us alone and everybody will behappier.

Introduction

In the world of hackers, the kind ofanswers you get to your technical questions depends as much on the wayyou ask the questions as on the difficulty of developing the answer.This guide will teach you how to ask questions in a way more likelyto get you a satisfactory answer.

Now that use of open source has become widespread, you canoften get as good answers from other, more experienced users as fromhackers. This is a Good Thing; users tend to be just a little bit moretolerant of the kind of failures newbies often have. Still, treatingexperienced users like hackers in the ways we recommend here willgenerally be the most effective way to get useful answers out of them,too.

The first thing to understand is that hackers actually like hardproblems and good, thought-provoking questions about them. If wedidn't, we wouldn't be here. If you give us an interesting questionto chew on we'll be grateful to you; good questions are a stimulus anda gift. Good questions help us develop our understanding, and oftenreveal problems we might not have noticed or thought about otherwise.Among hackers, Good question! is a strong and sincerecompliment.

Despite this, hackers have a reputation for meeting simplequestions with what looks like hostility or arrogance. It sometimeslooks like we're reflexively rude to newbies and the ignorant. Butthis isn't really true.

What we are, unapologetically, is hostile to people who seem tobe unwilling to think or to do their own homework before askingquestions. People like that are time sinks — they take withoutgiving back, and they waste time we could have spent on another questionmore interesting and another person more worthy of an answer. We callpeople like this losers (and for historical reasons wesometimes spell it lusers).

We realize that there are many people who just want to use thesoftware we write, and who have no interest in learning technicaldetails. For most people, a computer is merely a tool, a means to anend; they have more important things to do and lives to live. Weacknowledge that, and don't expect everyone to take an interest in thetechnical matters that fascinate us. Nevertheless, our style ofanswering questions is tuned for people who dotake such an interest and are willing to be active participants inproblem-solving. That's not going to change. Nor should it; if itdid, we would become less effective at the things we do best.

We're (largely) volunteers. We take time out of busy lives toanswer questions, and at times we're overwhelmed with them. So wefilter ruthlessly. In particular, we throw away questions from peoplewho appear to be losers in order to spend our question-answering timemore efficiently, on winners.

If you find this attitude obnoxious, condescending, or arrogant,check your assumptions. We're not asking you to genuflect to us— in fact, most of us would love nothing more than to deal withyou as an equal and welcome you into our culture, if you put in theeffort required to make that possible. But it's simply not efficientfor us to try to help people who are not willing to helpthemselves. It's OK to be ignorant; it's not OK to play stupid.

So, while it isn't necessary to already be technically competentto get attention from us, it is necessary todemonstrate the kind of attitude that leads to competence —alert, thoughtful, observant, willing to be an active partner indeveloping a solution. If you can't live with this sort ofdiscrimination, we suggest you pay somebody for a commercial supportcontract instead of asking hackers to personally donate help toyou.

If you decide to come to us for help, you don't want to be oneof the losers. You don't want to seem like one, either. The best wayto get a rapid and responsive answer is to ask it like a person withsmarts, confidence, and clues who just happens to need help on oneparticular problem.

(Improvements to this guide are welcome. You can mailsuggestions to esr@thyrsus.com or respond-auto@linuxmafia.com.Note however that this document is not intended to be a general guideto netiquette, and wewill generally reject suggestions that are not specifically related toeliciting useful answers in a technical forum.)

Before You Ask

Before asking a technical question by e-mail, or in a newsgroup, or on awebsite chat board, do the following:

  1. Try to find an answer by searching the archives of theforum or mailing list you plan to post to.

  2. Try to find an answer by searching the Web.

  3. Try to find an answer by reading the manual.

  4. Try to find an answer by reading a FAQ.

  5. Try to find an answer by inspection or experimentation.

  6. Try to find an answer by asking a skilled friend.

  7. If you're a programmer, try to find an answer by readingthe source code.

When you ask your question, display the fact that you have donethese things first; this will help establish that you're not being alazy sponge and wasting people's time. Better yet, display what you havelearned from doing these things. We like answeringquestions for people who have demonstrated they can learn fromthe answers.

Use tactics like doing a Google search on the text of whatevererror message you get (searching Google groups as well as Webpages). This might well take you straight to fix documentation or amailing list thread answering your question. Even if it doesn't,saying I googled on the following phrase but didn't getanything that looked promising is a good thing to do in e-mailor news postings requesting help, if only because it records whatsearches won't help. It will also help to direct other people withsimilar problems to your thread by linking the search terms to whatwill hopefully be your problem and resolution thread.

Take your time. Do not expect to be able to solve a complicatedproblem with a few seconds of Googling. Read and understand the FAQs,sit back, relax and give the problem some thought before approachingexperts. Trust us, they will be able to tell from your questions howmuch reading and thinking you did, and will be more willing to helpif you come prepared. Don't instantly fire your whole arsenal ofquestions just because your first search turned up no answers (or toomany).

Prepare your question. Think it through. Hasty-soundingquestions get hasty answers, or none at all. The more you do to demonstrate that having put thought and effort into solvingyour problem before seeking help, the more likely you are toactually get help.

Beware of asking the wrong question. If you ask one that isbased on faulty assumptions, J. Random Hacker is quite likely to replywith a uselessly literal answer while thinking Stupidquestion..., and hoping the experience of getting whatyou asked for rather than what you needed will teach you alesson.

Never assume you are entitled to an answer.You are not; you aren't, after all, paying for the service. You willearn an answer, if you earn it, by asking a substantial, interesting,and thought-provoking question — one that implicitly contributesto the experience of the community rather than merely passivelydemanding knowledge from others.

On the other hand, making it clear that you are able and willingto help in the process of developing the solution is a very goodstart. Would someone provide a pointer?, What is myexample missing?, and What site should I havechecked? are more likely to get answered than Pleasepost the exact procedure I should use. because you're making itclear that you're truly willing to complete the process if someone canjust point you in the right direction.

When You Ask

Choose your forum carefully

Be sensitive in choosing where you ask your question. You arelikely to be ignored, or written off as a loser, if you:

  • post your question to a forum where it's off topic

  • post a very elementary question to a forum whereadvanced technical questions are expected, or vice-versa

  • cross-post to too many different newsgroups

  • post a personal e-mail to somebody who is neitheran acquaintance of yours nor personally responsible for solving your problem

Hackers blow off questions that are inappropriately targeted inorder to try to protect their communications channels from beingdrowned in irrelevance. You don't want this to happen to you.

The first step, therefore, is to find the right forum. Again,Google and other Web-searching methods are your friend. Use them tofind the project webpage most closely associated with the hardware orsoftware giving you difficulties. Usually it will have links to a FAQ(Frequently Asked Questions) list, and to project mailing lists andtheir archives. These mailing lists are the final places to go forhelp, if your own efforts (including readingthose FAQs you found) do not find you a solution. The project pagemay also describe a bug-reporting procedure, or have a link to one; ifso, follow it.

Shooting off an e-mail to a person or forum which you are notfamiliar with is risky at best. For example, do not assume that theauthor of an informative webpage wants to be your free consultant.Do not make optimistic guesses about whether your question will bewelcome — if you're unsure, send it elsewhere, or refrain fromsending it at all.

When selecting a Web forum, newsgroup or mailing list, don'ttrust the name by itself too far; look for a FAQ or charter to verifyyour question is on-topic. Read some of the back traffic beforeposting so you'll get a feel for how things are done there. In fact,it's a very good idea to do a keyword search for words relating toyour problem on the newsgroup or mailing list archives before youpost. It may find you an answer, and if not it will help youformulate a better question.

Don't shotgun-blast all the available help channels at once, that'slike yelling and irritates people. Step through them softly.

Know what your topic is! One of the classic mistakes is askingquestions about the Unix or Windows programming interface in a forumdevoted to a language or library or tool portable across both.If you don't understand why this is a blunder, you'd be best off notasking any questions at all until you get it.

In general, questions to a well-selected public forum are morelikely to get useful answers than equivalent questions to a privateone. There are multiple reasons for this. One is simply the size ofthe pool of potential respondents. Another is the size of theaudience; hackers would rather answer questions that educate manypeople than questions serving only a few.

Understandably, skilled hackers and authors of popular software arealready receiving more than their fair share of mis-targeted messages.By adding to the flood, you could in extreme cases even be the strawthat breaks the camel's back — quite a few times, contributors topopular projects have withdrawn their support because collateraldamage in the form of useless e-mail traffic to their personal accountsbecame unbearable.

Stack Overflow

Search, then ask on Stack Exchange

In recent years, the Stack Exchange community of sites has emerged asa major resource for answering technical and other questions and iseven the preferred forum for many open-source projects.

Start with a Google search before looking at Stack Exchange; Googleindexes it in real time. There's a very good chance someone hasalready asked a similar question, and the Stack Exchange sites areoften near the top of the search results. If you didn't find anythingthrough Google, search again on the specific site most relevant toyour question (see below). Searching with tags can help narrow downthe results.

If you still didn't find anything, post your question on theone site where it's most on-topic. Use theformatting tools, especially for code, and add tags that are relatedto the substance of your question (particularly the name of theprogramming language, operating system, or library you're havingtrouble with). If a commenter asks you for more information, edit yourmain post to include it. If any answer is helpful, click the up arrowto upvote it; if an answer gives a solution to your problem, click thecheck under the voting arrows to accept it as correct.

Stack Exchange has grown to over 100 sites, but hereare the most likely candidates:

Several projects have their own specific sites, including Android,Ubuntu, TeX/LaTeX, and SharePoint. Check the Stack Exchange site foran up-to-date list.

Web and IRC forums

Your local user group, or your Linux distribution, may advertisea Web forum or IRC channel where newbies can get help. (Innon-English-speaking countries newbie forums are still more likely tobe mailing lists.) These are good first places to ask, especially ifyou think you may have tripped over a relatively simple or commonproblem. An advertised IRC channel is an open invitation to askquestions there and often get answers in real time.

In fact, if you got the program that is giving you problems froma Linux distribution (as is common today), it may be better to ask in thedistro's forum/list before trying the program's project forum/list. Theproject's hackers may just say, use ourbuild.

Before posting to any Web forum, check if it has a Searchfeature. If it does, try a couple of keyword searches forsomething like your problem; it just might help. If you did a generalWeb search before (as you should have), search the forum anyway; yourWeb-wide search engine might not have all of this forum indexedrecently.

There is an increasing tendency for projects to do user supportover a Web forum or IRC channel, with e-mail reserved more fordevelopment traffic. So look for those channels first when seekingproject-specific help.

In IRC, it's probably best not to dump a long problemdescription on the channel first thing; some people interpret thisas channel-flooding. Best to utter a one-line problem descriptionin a way pitched to start a conversation on the channel.

As a second step, use project mailing lists

When a project has a development mailing list, write to themailing list, not to individual developers, even if you believeyou know who can best answer your question. Check the documentationof the project and its homepage for the address of a project mailinglist, and use it. There are several good reasons for thispolicy:

  • Any question good enough to be asked of onedeveloper will also be of value to the whole group. Contrariwise, ifyou suspect your question is too dumb for a mailing list, it's notan excuse to harass individual developers.

  • Asking questions on the list distributes load amongdevelopers. The individual developer (especially if he's the projectleader) may be too busy to answer your questions.

  • Most mailing lists are archived and the archives areindexed by search engines. If you ask your question on-list and it isanswered, a future querent could find your question and the answer onthe Web instead of asking it again.

  • If certain questions are seen to be asked often,developers can use that information to improve the documentation or thesoftware itself to be less confusing. But if those questions areasked in private, nobody has the complete picture of what questionsare asked most often.

If a project has both a user and adeveloper (or hacker) mailing list orWeb forum, and you are not hacking on the code, ask in theuser list/forum. Do not assume that you willbe welcome on the developer list, where they're likely to experienceyour question as noise disrupting their developer traffic.

However, if you are sure your question isnon-trivial, and you get no answer in the userlist/forum for several days, try the developer one.You would be well advised to lurk there for a few daysor at leastreview the last few days of archived messages, to learn the localfolkways before posting (actually this is good advice on any private or semi-privatelist).

If you cannot find a project's mailing list address, but onlysee the address of the maintainer of the project, go ahead and writeto the maintainer. But even in that case, don't assume that themailing list doesn't exist. Mention in your e-mail that you tried andcould not find the appropriate mailing list. Also mention that youdon't object to having your message forwarded to other people. (Manypeople believe that private e-mail should remain private, even ifthere is nothing secret in it. By allowing your message to beforwarded you give your correspondent a choice about how to handleyour e-mail.)

Use meaningful, specific subject headers

On mailing lists, newsgroups or Web forums, the subject headeris your golden opportunity to attract qualified experts' attention inaround 50 characters or fewer. Don't waste it on babble likePlease help me (let alone PLEASE HELPME!!!!; messages with subjects like that get discarded byreflex). Don't try to impress us with the depth of your anguish; usethe space for a super-concise problem description instead.

One good convention for subject headers, used by many tech supportorganizations, is object - deviation. Theobject part specifies what thing or group of things ishaving a problem, and the deviation part describes thedeviation from expected behavior.

Stupid:

HELP! Video doesn't work properly on my laptop!

Smart:

X.org 6.8.1 misshapen mouse cursor, Fooware MV1005 vid. chipset

Smarter:

X.org 6.8.1 mouse cursor on Fooware MV1005 vid. chipset - is misshapen

The process of writing an object-deviationdescription will help you organize your thinking about the problem inmore detail. What is affected? Just the mouse cursor or othergraphics too? Is this specific to the X.org version of X? To version6.8.1? Is this specific to Fooware video chipsets? To model MV1005? Ahacker who sees the result can immediately understand what it is thatyou are having a problem with and the problem youare having, at a glance.

More generally, imagine looking at the index of an archive ofquestions, with just the subject lines showing. Make your subjectline reflect your question well enough that the next person searching thearchive with a question similar to yours will be able to follow thethread to an answer rather than posting the question again.

If you ask a question in a reply, be sure to change the subjectline to indicate that you're asking a question. A Subject line thatlooks like Re: test or Re: new bug isless likely to attract useful amounts of attention. Also, pare quotationof previous messages to the minimum consistent with cluing in newreaders.

Do not simply hit reply to a list message in order to start anentirely new thread. This will limit your audience. Some mail readers,like mutt, allow the user to sort by thread and then hide messages ina thread by folding the thread. Folks who do that will never see yourmessage.

Changing the subject is not sufficient. Mutt, and probably other mailreaders, looks at other information in the e-mail's headers to assignit to a thread, not the subject line. Instead start an entirely newe-mail.

On Web forums the rules of good practice are slightly different,because messages are usually much more tightly bound to specificdiscussion threads and often invisible outside those threads.Changing the subject when asking a question in reply is not essential.Not all forums even allow separate subject lines on replies, andnearly nobody reads them when they do. However, asking a question in areply is a dubious practice in itself, because it will only be seen bythose who are watching this thread. So, unless you are sure youwant to ask only the people currently active in thethread, start a new one.

Make it easy to reply

Finishing your query with Please send your replyto... makes it quite unlikely you will get an answer. If youcan't be bothered to take even the few seconds required to set up acorrect Reply-To header in your mail agent, we can't be bothered totake even a few seconds to think about your problem. If your mailprogram doesn't permit this, get a better mailprogram. If your operating system doesn't support any e-mailprograms that permit this, get a better operating system.

In Web forums, asking for a reply by e-mail is outright rude,unless you believe the information may be sensitive (and somebodywill, for some unknown reason, let you but not the whole forum knowit). If you want an e-mail copy when somebody replies in the thread,request that the Web forum send it; this feature is supportedalmost everywhere under options like watch this thread,send e-mail on answers, etc.

Write in clear, grammatical, correctly-spelled language

We've found by experience that people who are careless andsloppy writers are usually also careless and sloppy at thinking andcoding (often enough to bet on, anyway). Answering questions forcareless and sloppy thinkers is not rewarding; we'd rather spend ourtime elsewhere.

So expressing your question clearly and well is important. Ifyou can't be bothered to do that, we can't be bothered to payattention. Spend the extra effort to polish your language. Itdoesn't have to be stiff or formal — in fact, hacker culturevalues informal, slangy and humorous language used with precision.But it has to be precise; there has to be someindication that you're thinking and paying attention.

Spell, punctuate, and capitalize correctly. Don't confuseits with it's, loose withlose, or discrete withdiscreet. Don't TYPE IN ALL CAPS; this is read asshouting and considered rude. (All-smalls is only slightly lessannoying, as it's difficult to read. Alan Cox can get away with it,but you can't.)

More generally, if you write like a semi-literate boob you willvery likely be ignored. So don't use instant-messaging shortcuts.Spelling "you" as "u" makes you look like a semi-literate boob to savetwo entire keystrokes. Worse: writing like a l33t script kiddie hax0r isthe absolute kiss of death and guarantees you will receive nothing butstony silence (or, at best, a heaping helping of scorn and sarcasm) inreturn.

If you are asking questions in a forum that does not use yournative language, you will get a limited amount of slack for spellingand grammar errors — but no extra slack at all for laziness (andyes, we can usually spot that difference). Also, unless you know whatyour respondent's languages are, write in English. Busy hackers tendto simply flush questions in languages they don't understand, andEnglish is the working language of the Internet. By writing inEnglish you minimize your chances that your question will be discardedunread.

If you are writing in English but it is a second language foryou, it is good form to alert potential respondents to potentiallanguage difficulties and options for getting around them.Examples:

  • English is not my native language; please excuse typing errors.

  • If you speak $LANGUAGE, please email/PM me; I may need assistancetranslating my question.

  • I am familiar with the technical terms, but some slang expressions andidioms are difficult for me.

  • I've posted my question in $LANGUAGE and English. I'll be glad totranslate responses, if you only use one or the other.

Send questions in accessible, standard formats

If you make your question artificially hard to read, it is morelikely to be passed over in favor of one that isn't. So:

  • Send plain text mail, not HTML. (It's not hardto turn off HTML.)

  • MIME attachments are usually OK, but only if they arereal content (such as an attached source file or patch), and notmerely boilerplate generated by your mail client (such as another copyof your message).

  • Don't send e-mail in which entire paragraphs are singlemultiply-wrapped lines. (This makes it too difficult to reply to just part of the message.) Assume that your respondents will bereading mail on 80-character-wide text displays and set your line wrap accordingly, to something less than 80.

  • However, do not wrap data (suchas log file dumps or session transcripts) at any fixed column width.Data should be included as-is, so respondents can have confidencethat they are seeing what you saw.

  • Don't send MIME Quoted-Printable encoding to anEnglish-language forum. This encoding can be necessary when you'reposting in a language ASCII doesn't cover, but many e-mail agentsdon't support it. When they break, all those =20 glyphs scatteredthrough the text are ugly and distracting — or may activelysabotage the semantics of your text.

  • Never, ever expect hackers to beable to read closed proprietary document formats like Microsoft Wordor Excel. Most hackers react to these about as well as you would tohaving a pile of steaming pig manure dumped on your doorstep. Evenwhen they can cope, they resent having to do so.

  • If you're sending e-mail from a Windows machine, turnoff Microsoft's problematic Smart Quotes feature (FromTools > AutoCorrect Options, clear the smart quotes checkbox underAutoFormat As You Type.). This is so you'll avoid sprinkling garbagecharacters through your mail.

  • In Web forums, do not abuse smiley andHTML features (when they are present). A smiley or twois usually OK, but colored fancy text tends to make people think youare lame. Seriously overusing smileys and color and fonts will makeyou come off like a giggly teenage girl, which is not generally a goodidea unless you are more interested in sex than answers.

If you're using a graphical-user-interface mail client such asNetscape Messenger, MS Outlook, or their ilk, beware that it mayviolate these rules when used with its default settings. Most suchclients have a menu-based View Source command. Usethis on something in your sent-mail folder, verifying sending of plaintext without unnecessary attached crud.

Be precise and informative about your problem

  • Describe the symptoms of your problem or bug carefully and clearly.

  • Describe the environment in which it occurs (machine, OS, application,whatever). Provide your vendor's distribution and release level(e.g.: Fedora Core 7, Slackware 9.1, etc.).

  • Describe the research you did to try and understand the problem before you asked the question.

  • Describe the diagnostic steps you took to try and pin down the problemyourself before you asked the question.

  • Describe any possibly relevant recent changes in your computer orsoftware configuration.

  • If at all possible, provide a way to reproduce theproblem in a controlled environment.

Do the best you can to anticipate the questions a hacker willask, and answer them in advance in your request for help.

Giving hackers the ability to reproduce the problem in acontrolled environment is especially important if you are reportingsomething you think is a bug in code. When you do this, your odds ofgetting a useful answer and the speed with which you are likely to getthat answer both improve tremendously.

Simon Tatham has written an excellent essay entitled How toReport Bugs Effectively. I strongly recommend thatyou read it.

Volume is not precision

You need to be precise and informative. This end is not servedby simply dumping huge volumes of code or data into a help request.If you have a large, complicated test case that is breaking a program,try to trim it and make it as small as possible.

This is useful for at least three reasons. One: being seen toinvest effort in simplifying the question makes it more likely you'll get an answer, Two: simplifying the question makes it morelikely you'll get a useful answer. Three:In the process of refining your bug report, you may develop a fix or workaround yourself.

Don't rush to claim that you have found a bug

When you are having problems with a piece of software, don'tclaim you have found a bug unless you are very,very sure of your ground. Hint: unless you canprovide a source-code patch that fixes the problem, or a regressiontest against a previous version that demonstrates incorrect behavior,you are probably not sure enough. This applies to webpages anddocumentation, too; if you have found a documentationbug, you should supply replacement text and which pagesit should go on.

Remember, there are many other users that are notexperiencing your problem. Otherwise you would have learned about itwhile reading the documentation and searching the Web (you did do thatbefore complaining, didn't you?). Thismeans that very probably it is you who are doing something wrong, notthe software.

The people who wrote the software work very hard to make it workas well as possible. If you claim you have found a bug, you'll beimpugning their competence, which may offend some of them even if youare correct. It's especially undiplomatic to yell bugin the Subject line.

When asking your question, it is best to write as though youassume you are doing something wrong, even if youare privately pretty sure you have found an actual bug. If therereally is a bug, you will hear about it in the answer. Play it so themaintainers will want to apologize to you if the bug is real, ratherthan so that you will owe them an apology if you have messed up.

Grovelling is not a substitute for doing your homework

Some people who get that they shouldn't behave rudely orarrogantly, demanding an answer, retreat to the opposite extreme ofgrovelling. I know I'm just a pathetic newbie loser,but.... This is distracting and unhelpful. It's especiallyannoying when it's coupled with vagueness about the actualproblem.

Don't waste your time, or ours, on crude primate politics.Instead, present the background facts and your question as clearly asyou can. That is a better way to position yourself than bygrovelling.

Sometimes Web forums have separate places for newbie questions. If youfeel you do have a newbie question, just go there. But don't grovel thereeither.

Describe the problem's symptoms, not your guesses

It's not useful to tell hackers what you think is causing yourproblem. (If your diagnostic theories were such hot stuff, would yoube consulting others for help?) So, make sure you're telling them theraw symptoms of what goes wrong, rather than your interpretations andtheories. Let them do the interpretation and diagnosis. If you feelit's important to state your guess, clearly label it as such anddescribe why that answer isn't working for you.

Stupid:

I'm getting back-to-back SIG11 errors on kernel compiles, and suspect ahairline crack on one of the motherboard traces. What's the best way tocheck for those?

Smart:

My home-built K6/233 on an FIC-PA2007 motherboard (VIA Apollo VP2chipset) with 256MB Corsair PC133 SDRAM starts getting frequent SIG11errors about 20 minutes after power-on during the course of kernelcompiles, but never in the first 20 minutes. Rebooting doesn't restartthe clock, but powering down overnight does. Swapping out all RAMdidn't help. The relevant part of a typical compile session logfollows.

Since the preceding point seems to be a tough one for many people tograsp, here's a phrase to remind you: "All diagnosticians are fromMissouri." That US state's official motto is "Show me" (earned in1899, when Congressman Willard D. Vandiver said "I come from a countrythat raises corn and cotton and co*ckleburs and Democrats, and frothyeloquence neither convinces nor satisfies me. I'm from Missouri.You've got to show me.") In diagnosticians' case, it's not a matter ofskepticism, but rather a literal, functional need to see whatever isas close as possible to the same raw evidence that you see, ratherthan your surmises and summaries. Show us.

Describe your problem's symptoms in chronological order

The clues most useful in figuring out something that went wrongoften lie in the events immediately prior. So, your account shoulddescribe precisely what you did, and what the machine and softwaredid, leading up to the blowup. In the case of command-line processes,having a session log (e.g., using the script utility) and quoting therelevant twenty or so lines is very useful.

If the program that blew up on you has diagnostic options (suchas -v for verbose), try to select options that will add usefuldebugging information to the transcript. Remember that more is notnecessarily better; try to choose a debug level that will informrather than drowning the reader in junk.

If your account ends up being long (more than about four paragraphs),it might be useful to succinctly state the problem up top, thenfollow with the chronological tale. That way, hackers will knowwhat to watch for in reading your account.

Describe the goal, not the step

If you are trying to find out how to do something (as opposed toreporting a bug), begin by describing the goal. Only then describethe particular step towards it that you are blocked on.

Often, people who need technical help have a high-level goal inmind and get stuck on what they think is one particular path towardsthe goal. They come for help with the step, but don't realize thatthe path is wrong. It can take substantial effort to get pastthis.

Stupid:

How do I get the color-picker on the FooDraw program to take ahexadecimal RGB value?

Smart:

I'm trying to replace the color table on an image with valuesof my choosing. Right now the only way I can see to do this is byediting each table slot, but I can't get FooDraw's color picker to take a hexadecimal RGB value.

The second version of the question is smart. It allows ananswer that suggests a tool better suited to the task.

Don't ask people to reply by private e-mail

Hackers believe solving problems should be a public, transparentprocess during which a first try at an answer can and should becorrected if someone more knowledgeable notices that it is incomplete orincorrect. Also, helpers get some of their reward for beingrespondents from being seen to be competent and knowledgeable bytheir peers.

When you ask for a private reply, you are disrupting both theprocess and the reward. Don't do this. It's therespondent's choice whether to reply privately— and if he or she does, it's usually because he or she thinksthe question is too ill-formed or obvious to be interesting toothers.

There is one limited exception to this rule. If you thinkthe question is such that you are likely to get many answers thatare all closely similar, then the magic words are e-mail me and I'llsummarize the answers for the group. It is courteous to try and save the mailing list or newsgroup a flood of substantially identicalpostings — but you have to keep the promise to summarize.

Be explicit about your question

Open-ended questions tend to be perceived as open-ended timesinks. Those people most likely to be able to give you a useful answerare also the busiest people (if only because they take on the mostwork themselves). People like that are allergic to open-ended timesinks, thus they tend to be allergic to open-ended questions.

You are more likely to get a useful response if you areexplicit about what you want respondents to do (provide pointers,send code, check your patch, whatever). This will focus their effort and implicitly put an upper bound on the time and energy a respondent must allocate to helping you. This is good.

To understand the world the experts live in, think of expertiseas an abundant resource and time to respond as a scarce one. The lessof a time commitment you implicitly ask for, the more likely you areto get an answer from someone really good and really busy.

So it is useful to frame your question to minimize the timecommitment required for an expert to field it — but this isoften not the same thing as simplifying the question. Thus, forexample, Would you give me a pointer to a good explanation ofX? is usually a smarter question than Would you explainX, please?. If you have some malfunctioning code, it isusually smarter to ask for someone to explain what's wrong with itthan it is to ask someone to fix it.

When asking about code

Don't ask others to debug your broken code without giving a hintwhat sort of problem they should be searching for. Posting a fewhundred lines of code, saying "it doesn't work", will get you ignored.Posting a dozen lines of code, saying "after line 7 I was expecting tosee <x>, but <y> occurred instead" is much more likely toget you a response.

The most effective way to be precise about a code problem is toprovide a minimal bug-demonstrating test case. What's a minimal testcase? It's an illustration of the problem; just enough code toexhibit the undesirable behavior and no more. How do you make aminimal test case? If you know what line or section of code isproducing the problematic behavior, make a copy of it and add justenough supporting code to produce a complete example (i.e. enough thatthe source is acceptable to the compiler/interpreter/whateverapplication processes it). If you can't narrow it down to aparticular section, make a copy of the source and start removingchunks that don't affect the problematic behavior. The smaller yourminimal test case is, the better (see the section called “Volume is not precision”).

Generating a really small minimal test case will not always bepossible, but trying to is good discipline. It may help you learnwhat you need to solve the problem on your own — and even whenit doesn't, hackers like to see that you have tried. It willmake them more cooperative.

If you simply want a code review, say as much up front, and besure to mention what areas you think might particularly need reviewand why.

Don't post homework questions

Hackers are good at spotting homework questions; most of us havedone them ourselves. Those questions are for you to work out, so that you will learn from the experience. It is OK toask for hints, but not for entire solutions.

If you suspect you have been passed a homework question, butcan't solve it anyway, try asking in a user group forum or (as a lastresort) in a user list/forum of a project. While thehackers will spot it, some of the advanced usersmay at least give you a hint.

Prune pointless queries

Resist the temptation to close your request for help withsemantically-null questions like Can anyone help me? orIs there an answer? First: if you've written yourproblem description halfway competently, such tacked-on questions areat best superfluous. Second: because they are superfluous, hackersfind them annoying — and are likely to return logicallyimpeccable but dismissive answers like Yes, you can behelped and No, there is no help for you.

In general, asking yes-or-no questions is a good thing to avoidunless you want a yes-or-noanswer.

Don't flag your question as Urgent, even if it is for you

That's your problem, not ours. Claiming urgency is very likelyto be counter-productive: most hackers will simply delete suchmessages as rude and selfish attempts to elicit immediate and specialattention. Furthermore, the word 'Urgent' (and other similar attemptsto grab attention in the subject line) often triggers spam filters - your intended recipients might never see it at all!

There is one semi-exception. It can be worth mentioning ifyou're using the program in some high-profile place, one that thehackers will get excited about; in such a case, if you're under timepressure, and you say so politely, people may get interested enough toanswer faster.

This is a very risky thing to do, however, because the hackers'metric for what is exciting probably differs from yours. Posting fromthe International Space Station would qualify, for example, butposting on behalf of a feel-good charitable or political cause wouldalmost certainly not. In fact, posting Urgent: Help me save the fuzzy baby seals! will reliably get you shunned or flamedeven by hackers who think fuzzy baby seals are important.

If you find this mysterious, re-read the rest of this how-torepeatedly until you understand it before posting anything atall.

Courtesy never hurts, and sometimes helps

Be courteous. Use Please and Thanks foryour attention or Thanks for yourconsideration. Make it clear you appreciate the timepeople spend helping you for free.

To be honest, this isn't as important as (and cannot substitutefor) being grammatical, clear, precise and descriptive, avoidingproprietary formats etc.; hackers in general would rather get somewhatbrusque but technically sharp bug reports than polite vagueness. (Ifthis puzzles you, remember that we value a question by what it teachesus.)

However, if you've got your technical ducks in a row,politeness does increase your chances of getting a usefulanswer.

(We must note that the only serious objection we've receivedfrom veteran hackers to this HOWTO is with respect to our previousrecommendation to use Thanks in advance. Some hackersfeel this connotes an intention not to thank anybody afterwards. Ourrecommendation is to either say Thanks in advance firstand thank respondents afterwards, or expresscourtesy in a different way, such as by saying Thanks for yourattention or Thanks for yourconsideration.)

Follow up with a brief note on the solution

Send a note after the problem has been solved to all who helpedyou; let them know how it came out and thank them again for theirhelp. If the problem attracted general interest in a mailing list ornewsgroup, it's appropriate to post the followup there.

Optimally, the reply should be to the thread started by theoriginal question posting, and should have ‘FIXED’,‘RESOLVED’ or an equally obvious tag in the subject line.On mailing lists with fast turnaround, a potential respondent who seesa thread about Problem X ending with Problem X -FIXED knows not to waste his/her time even reading the thread(unless (s)he personally finds Problem X interesting) and cantherefore use that time solving a different problem.

Your followup doesn't have to be long and involved; a simpleHowdy — it was a failed network cable! Thanks, everyone. -Bill would be better than nothing. In fact, a short and sweetsummary is better than a long dissertation unless the solution hasreal technical depth. Say what action solved the problem, but youneed not replay the whole troubleshooting sequence.

For problems with some depth, it is appropriate to post asummary of the troubleshooting history. Describe your final problemstatement. Describe what worked as a solution, and indicate avoidableblind alleys after that. The blind alleys shouldcome after the correct solution and other summary material, ratherthan turning the follow-up into a detective story. Name the names ofpeople who helped you; you'll make friends that way.

Besides being courteous and informative, this sort of followupwill help others searching the archive of the mailing-list/newsgroup/forumto know exactly which solution helped you and thus may also helpthem.

Last, and not least, this sort of followup helps everybody whoassisted feel a satisfying sense of closure about the problem. If youare not a techie or hacker yourself, trust us that this feeling isvery important to the gurus and experts you tapped for help. Problemnarratives that trail off into unresolved nothingness are frustratingthings; hackers itch to see them resolved. The goodwill thatscratching that itch earns you will be very, very helpful to you nexttime you need to pose a question.

Consider how you might be able to prevent others from having thesame problem in the future. Ask yourself if a documentation or FAQpatch would help, and if the answer is yes send that patch to themaintainer.

Among hackers, this sort of good followup behavior is actuallymore important than conventional politeness. It's how you get areputation for playing well with others, which can be a very valuableasset.

How To Interpret Answers

RTFM and STFW: How To Tell You've Seriously Screwed Up

There is an ancient and hallowed tradition: if you get a replythat reads RTFM, the person who sent it thinks youshould have Read The f*cking Manual. He or she is almost certainly right.Go read it.

RTFM has a younger relative. If you get a reply that readsSTFW, the person who sent it thinks you should haveSearched The f*cking Web. He or she is almost certainly right. Go searchit. (The milder version of this is when you are told Google isyour friend!)

In Web forums, you may also be told to search the forumarchives. In fact, someone may even be so kind as to provide a pointerto the previous thread where this problem was solved. But do not relyon this consideration; do your archive-searching before asking.

Often, the person telling you to do a search has the manual orthe web page with the information you need open, and is looking at itas he or she types. These replies mean that the responder thinks (a)the information you need is easy to find, and (b) you will learn moreif you seek out the information than if you have it spoon-fed toyou.

You shouldn't be offended by this; by hacker standards, yourrespondent is showing you a rough kind of respect simply by notignoring you. You should instead be thankful for this grandmotherlykindness.

If you don't understand...

If you don't understand the answer, do not immediately bounceback a demand for clarification. Use the same tools that you used totry and answer your original question (manuals, FAQs, the Web, skilledfriends) to understand the answer. Then, if you still need to ask forclarification, exhibit what you have learned.

For example, suppose I tell you: It sounds like you'vegot a stuck zentry; you'll need to clear it. Then: here's abad followup question: What's azentry? Here's a good followupquestion: OK, I read the man page and zentries are onlymentioned under the -z and -p switches. Neither of them says anythingabout clearing zentries. Is it one of these or am I missing somethinghere?

Dealing with rudeness

Much of what looks like rudeness in hacker circles is notintended to give offense. Rather, it's the product of the direct,cut-through-the-bullsh*t communications style that is natural topeople who are more concerned about solving problems than makingothers feel warm and fuzzy.

When you perceive rudeness, try to react calmly. If someoneis really acting out, it is very likely a senior person on thelist or newsgroup or forum will call him or her on it. If that doesn't happen and you lose your temper, itis likely that the person you lose it at was behaving within thehacker community's norms and you will beconsidered at fault. This will hurt your chances of getting theinformation or help you want.

On the other hand, you will occasionally run across rudeness andposturing that is quite gratuitous. The flip-side of the above isthat it is acceptable form to slam real offenders quite hard,dissecting their misbehavior with a sharp verbal scalpel. Be very,very sure of your ground before you try this, however. The linebetween correcting an incivility and starting a pointless flamewar is thinenough that hackers themselves not infrequently blunder across it; ifyou are a newbie or an outsider, your chances of avoiding such ablunder are low. If you're after information rather than entertainment,it's better to keep your fingers off the keyboard than to risk this.

(Some people assert that many hackers have a mild form of autismor Asperger's Syndrome, and are actually missing some of the braincircuitry that lubricates normal human socialinteraction. This may or may not be true. If you are not a hackeryourself, it may help you cope with our eccentricities if you think ofus as being brain-damaged. Go right ahead. We won't care; welike being whatever it is we are, and generallyhave a healthy skepticism about clinical labels.)

Jeff Bigler's observations abouttact filtersare also relevant and worth reading.

In the next section, we'll talk about a different issue; the kind of rudeness you'll see when you misbehave.

On Not Reacting Like A Loser

Odds are you'll screw up a few times on hacker communityforums — in ways detailed in this article, or similar. Andyou'll be told exactly how you screwed up, possibly with colourfulasides. In public.

When this happens, the worst thing you can do is whine about theexperience, claim to have been verbally assaulted, demand apologies,scream, hold your breath, threaten lawsuits, complain to people'semployers, leave the toilet seat up, etc. Instead, here's what youdo:

Get over it. It's normal. In fact, it's healthy and appropriate.

Community standards do not maintain themselves: They'remaintained by people actively applying them, visibly, inpublic. Don't whine that all criticism should have beenconveyed via private e-mail: That's not how it works. Nor is it usefulto insist you've been personally insulted when someone comments thatone of your claims was wrong, or that his views differ. Those areloser attitudes.

There have been hacker forums where, out of some misguided sense ofhyper-courtesy, participants are banned from posting any fault-findingwith another's posts, and told Don't say anything if you're unwillingto help the user. The resulting departure of clueful participants toelsewhere causes them to descend into meaningless babble and becomeuseless as technical forums.

Exaggeratedly friendly (in that fashion) or useful: Pick one.

Remember: When that hacker tells you that you've screwed up, and (nomatter how gruffly) tells you not to do it again, he's acting out ofconcern for (1) you and (2) his community. It would be much easier for himto ignore you and filter you out of his life. If you can't manage to begrateful, at least have a little dignity, don't whine, and don't expectto be treated like a fragile doll just because you're a newcomer witha theatrically hypersensitive soul and delusions of entitlement.

Sometimes people will attack you personally, flame without anapparent reason, etc., even if you don't screw up (or have onlyscrewed up in their imagination). In this case, complaining is the wayto really screw up.

These flamers are either lamers who don't have a clue butbelieve themselves to be experts, or would-be psychologists testingwhether you'll screw up. The other readers either ignore them, or findways to deal with them on their own. The flamers' behavior createsproblems for themselves, which don't have to concern you.

Don't let yourself be drawn into a flamewar, either. Most flamesare best ignored — after you've checked whether they are really flames,not pointers to the ways in which you have screwed up, and not cleverlyciphered answers to your real question (this happens as well).

Questions Not To Ask

Here are some classic stupid questions, and what hackers are thinkingwhen they don't answer them.

Q: Where can I find program or resource X?
Q: How can I use X to do Y?
Q: How can I configure my shell prompt?
Q: Can I convert an AcmeCorp document into a TeX file usingthe Bass-o-matic file converter?
Q: My {program, configuration, SQL statement} doesn't work
Q: I'm having problems with my Windows machine. Can you help?
Q: My program doesn't work. I think system facility X is broken.
Q: I'm having problems installing Linux or X. Can you help?
Q: How can I crack root/steal channel-ops privileges/read someone'se-mail?

Q:

Where can I find program or resource X?

A:

The same place I'd find it, fool — at the other end of aweb search. Ghod, doesn't everybody know how to use Google yet?

Q:

How can I use X to do Y?

A:

If what you want is to do Y, you should ask that questionwithout pre-supposing the use of a method that may not be appropriate.Questions of this form often indicate a person who is not merelyignorant about X, but confused about what problem Y they are solvingand too fixated on the details of their particular situation. It isgenerally best to ignore such people until they define their problembetter.

Q:

How can I configure my shell prompt?

A:

If you're smart enough to ask this question, you're smart enoughto RTFM and find out yourself.

Q:

Can I convert an AcmeCorp document into a TeX file usingthe Bass-o-matic file converter?

A:

Try it and see. If you did that, you'd (a) learn the answer, and (b) stop wasting my time.

Q:

My {program, configuration, SQL statement} doesn't work

A:

This is not a question, and I'm not interested in playingTwenty Questions to pry your actual question out of you — I havebetter things to do. On seeing something like this, my reaction isnormally of one of the following:

  • do you have anything else to add to that?

  • oh, that's too bad, I hope you get it fixed.

  • and this has exactly what to do with me?

Q:

I'm having problems with my Windows machine. Can you help?

A:

Yes. Throw out that Microsoft trash and install an open-sourceoperating system like Linux or BSD.

Note: you can ask questions related toWindows machines if they are about a program that does have anofficial Windows build, or interacts with Windows machines(i.e., Samba). Just don't be surprised by the reply that the problem iswith Windows and not the program, because Windows is so broken ingeneral that this is very often the case.

Q:

My program doesn't work. I think system facility X is broken.

A:

While it is possible that you are the first person to notice anobvious deficiency in system calls and libraries heavily used byhundreds or thousands of people, it is rather more likely that you areutterly clueless. Extraordinary claims require extraordinary evidence;when you make a claim like this one, you must back it up with clearand exhaustive documentation of the failure case.

Q:

I'm having problems installing Linux or X. Can you help?

A:

No. I'd need hands-on access to your machine to troubleshootthis. Go ask your local Linux user group for hands-on help. (You canfind a list of user groups here.)

Note: questions about installing Linux may be appropriate ifyou're on a forum or mailing list about a particular distribution, and theproblem is with that distro; or on local usergroups forums. In this case, be sure to describe the exact details ofthe failure. But do careful searching first, with "linux" andall suspicious pieces of hardware.

Q:

How can I crack root/steal channel-ops privileges/read someone'se-mail?

A:

You're a lowlife for wanting to do such things and a moron for asking a hacker to help you.

Good and Bad Questions

Finally, I'm going to illustrate how to ask questions in a smart wayby example; pairs of questions about the same problem, one asked in a stupid way and one in a smart way.

Stupid:Where can I find out stuff about the Foonly Flurbamatic?

This question just begs for "STFW" as areply.

Smart:I used Google to try to find Foonly Flurbamatic 2600 onthe Web, but I got no useful hits. Can I get a pointer toprogramming information on this device?

This one has already STFWed, and sounds like there might be a realproblem.

Stupid:I can't get the code from project foo to compile. Why is it broken?

The querent assumes that somebody else screwed up. Arrogant git...

Smart:The code from project foo doesn't compile under Nulix version 6.2. I've read the FAQ, but it doesn't have anything in it aboutNulix-related problems. Here's a transcript of my compilationattempt; is it something I did?

The querent has specified the environment, read the FAQ, is showingthe error, and is not assuming his problems are someone else'sfault. This one might be worth some attention.

Stupid:I'm having problems with my motherboard. Can anybody help?

J. Random Hacker's response to this is likely to be Right. Do youneed burping and diapering, too? followed by a punch of the deletekey.

Smart:I tried X, Y, and Z on the S2464 motherboard. When that didn't work,I tried A, B, and C. Note the curious symptom when I tried C.Obviously the florbish is grommicking, but the results aren't what onemight expect. What are the usual causes of grommicking on Athlon MPmotherboards? Anybody got ideas for more tests I can run to pin downthe problem?

This person, on the other hand, seems worthy of ananswer. He/she has exhibited problem-solving intelligence rather thanpassively waiting for an answer to drop from on high.

In the last question, notice the subtle but important differencebetween demanding Give me an answer and Pleasehelp me figure out what additional diagnostics I can run to achieveenlightenment.

In fact, the form of that last question is closely based on areal incident that happened in August 2001 on the linux-kernel mailinglist (lkml). I (Eric) was the one asking the question that time. I wasseeing mysterious lockups on a Tyan S2462 motherboard. Thelist members supplied the critical information I needed to solvethem.

By asking the question in the way I did, I gave people somethingto chew on; I made it easy and attractive for them to get involved. Idemonstrated respect for my peers' ability and invited them to consultwith me as a peer. I also demonstrated respect for the value of theirtime by telling them the blind alleys I had already run down.

Afterwards, when I thanked everyone and remarked how well theprocess had worked, an lkml member observed that he thought it hadworked not because I'm a name on that list, but becauseI asked the question in the proper form.

Hackers are in some ways a very ruthless meritocracy; I'mcertain he was right, and that if I had behavedlike a sponge I would have been flamed or ignored no matter who I was.His suggestion that I write up the whole incident as instruction toothers led directly to the composition of this guide.

If You Can't Get An Answer

If you can't get an answer, please don't take it personally thatwe don't feel we can help you. Sometimes the members of the askedgroup may simply not know the answer. No response is not the sameas being ignored, though admittedly it's hard to spot the differencefrom outside.

In general, simply re-posting your question is a bad idea. Thiswill be seen as pointlessly annoying. Have patience: the person withyour answer may be in a different time-zone and asleep. Or it may bethat your question wasn't well-formed to begin with.

There are other sources of help you can go to, often sourcesbetter adapted to a novice's needs.

There are many online and local user groups who are enthusiastsabout the software, even though they may never have written anysoftware themselves. These groups often form so that people can helpeach other and help new users.

There are also plenty of commercial companies you can contractwith for help, both large and small. Don't be dismayed at the ideaof having to pay for a bit of help! After all, if your car engineblows a head gasket, chances are you would take it to a repair shopand pay to get it fixed. Even if the software didn't cost youanything, you can't expect that support to always come forfree.

For popular software like Linux, there are at least 10,000 usersper developer. It's just not possible for one person to handle thesupport calls from over 10,000 users. Remember that even if you have topay for support, you are still paying much less than if you had to buythe software as well (and support for closed-source software is usually moreexpensive and less competent than support for open-source software).

How To Answer Questions in a Helpful Way

Be gentle. Problem-related stress can makepeople seem rude or stupid even when they're not.

Reply to a first offender off-line. Thereis no need of public humiliation for someone who may have made anhonest mistake. A real newbie may not know how to search archives orwhere the FAQ is stored or posted.

If you don't know for sure, say so! A wrongbut authoritative-sounding answer is worse than none at all. Don'tpoint anyone down a wrong path simply because it's fun to sound likean expert. Be humble and honest; set a good example for both thequerent and your peers.

If you can't help, don't hinder. Don't makejokes about procedures that could trash the user's setup — thepoor sap might interpret these as instructions.

Ask probing questions to elicit moredetails. If you're good at this, the querent will learnsomething — and so might you. Try to turn the bad question intoa good one; remember we were all newbies once.

While muttering RTFM is sometimes justified when replyingto someone who is just a lazy slob, a pointer to documentation (evenif it's just a suggestion to google for a key phrase) isbetter.

If you're going to answer the question at all, givegood value. Don't suggest kludgy workarounds when somebodyis using the wrong tool or approach. Suggest good tools. Reframe thequestion.

Answer the actual question! If the querent has been so thoroughas to do his or her research and has included in the query that X, Y,Z, A, B, and C have already been tried without good result, it issupremely unhelpful to respond with Try A or B, or witha link to something that only says, Try X, Y, Z, A, B, orC..

Help your community learn from thequestion. When you field a good question, ask yourselfHow would the relevant documentation or FAQ have to change sothat nobody has to answer this again? Then send a patch to thedocument maintainer.

If you did research to answer the question, demonstrate yourskills rather than writing as though you pulled the answer out of yourbutt. Answering one good question is like feeding a hungry personone meal, but teaching them research skills by example is showingthem how to grow food for a lifetime.

Related Resources

If you need instruction in the basics of how personal computers,Unix, and the Internet work, seeThe Unix and Internet Fundamentals HOWTO.

When you release software or write patches for software, try tofollow the guidelines in the Software Release Practice HOWTO.

Acknowledgements

Evelyn Mitchell contributed some example stupid questions andinspired the How To Give A Good Answer section. MikhailRamendik contributed some particularly valuable suggestions forimprovements.

How To Ask Questions The Smart Way (2024)
Top Articles
Latest Posts
Article information

Author: Ray Christiansen

Last Updated:

Views: 6323

Rating: 4.9 / 5 (69 voted)

Reviews: 84% of readers found this page helpful

Author information

Name: Ray Christiansen

Birthday: 1998-05-04

Address: Apt. 814 34339 Sauer Islands, Hirtheville, GA 02446-8771

Phone: +337636892828

Job: Lead Hospitality Designer

Hobby: Urban exploration, Tai chi, Lockpicking, Fashion, Gunsmithing, Pottery, Geocaching

Introduction: My name is Ray Christiansen, I am a fair, good, cute, gentle, vast, glamorous, excited person who loves writing and wants to share my knowledge and understanding with you.