Updated: 2013-03-20 17:08 EDT

1 How to Ask Good Questions and Report Problems Well

If you have been sent to read this file, it is likely because your questions are too vague for me to answer. If you follow this advice I’ll be able to help you more quickly.

1.1 Be Very, Very Specific

When you ask me a question, the quality of the answer you get depends largely on how detailed and specific you are in your questions.

I can’t help with or answer a vague question such as “I can’t log in - do you know why?”, or “I can’t do question 3” any more than a mechanic can answer a question “My car won’t start - do you know why?”. You must be precise in your question, giving me as much information as you can about your situation.

Things you might consider telling me when you ask a question:

  1. Which assignment question are you trying to answer?

  2. What have you tried already? What, exactly, did you enter into the program? That includes exact keystrokes, addresses, names, etc. Tell me what exactly you used. Saying “I entered the information from the notes” is not helpful, since perhaps the notes are wrong, or perhaps you typed it wrong. What exactly did you type?

  3. What have you read to help solve your problem? Before you contact me, I expect you to read the lecture notes you took in class, the assignment (all the words!), and any posted class notes related to the problem.

  4. If it’s a network issue, then where are you, physically? At a coffee shop? At home? At school (in which room or which lab at school)? Where are you on the network? On wireless? Direct connect? Using a VPN? Using an ISP (NCF, TekSavvy, Rogers, Sympatico)? Cable, ADSL, or dial-up? Behind a firewall/router? Behind Network Address Translation (NAT)? Is the network working?

  5. If you use multiple machines, what machine and operating system are you using? Ubuntu Linux 12.04 on a Dell laptop? Windows XP on a home- built desktop machine?

  6. What program(s) are you using? Command-line FTP? PuTTY version 0,60? Firefox 9.0? DOS window FTP? What version?

  7. What messages did the program(s) already give you? That includes the exact text of the messages, not what you “think” it said. Copy the exact text of what the program said into your question to me.

1.2 Find Your Own Answers

For most questions, my job as instructor is to help you find the answer, not to give you the answer. Specific answers will change and become irrelevant over time, but knowing how to find an answer is always useful. You’ve already paid me, as a College instructor, to help you find answers.

If you want me to actually give you the answers, that’s called “private consulting” and the rates are much higher - contact me after you graduate.

You will get better at finding your own answers as you know more and become more familiar with search tools and asking the right questions. The first step is to realize that learning to find answers is a skill you can, and must, learn.

1.3 Search the Course Notes - READ ALL THE WORDS

Many questions are not new; other people have already asked them, and I’ve already incorporated the answers into the labs and the course notes. Before you ask a question, make sure I haven’t already answered it.

Learn to search the assignments and course notes for your answers. You can use the page-search features of web browsers to look for keywords in web pages, you can search for keywords in word-processor documents, and you can use “grep” at the Unix/Linux command line to search many text or HTML files at once. (The “-i” and “-r” options to grep are useful.)

Searching the assignment or the course notes is very efficient. You might be able to use Google to find your own answer on the Internet, but often Google hasn’t indexed my course notes yet so the specific information you need won’t be on the Internet yet. You will also find it harder to see the specific information that I give you among the billions of web pages that Google will suggest to you for answers.

I usually ask questions based on material in the labs and course notes. Check the labs and course notes for answers, first.

2 Asking Questions on the Internet

For a slightly abusive but very thorough explanation of how to ask “smart” questions and get good answers from busy people on the Internet, read the classic document “How To Ask Questions The Smart Way” by Eric S. Raymond and Rick Moen: http://www.catb.org/~esr/faqs/smart-questions.html

3 Examples of Questions I Cannot Answer

Here are some actual vague questions that have been sent to me that I would like to answer but cannot because the poser didn’t supply me with enough specific information (e.g. what exactly they did) to help:

Author: 
| Ian! D. Allen  -  idallen@idallen.ca  -  Ottawa, Ontario, Canada
| Home Page: http://idallen.com/   Contact Improv: http://contactimprov.ca/
| College professor (Free/Libre GNU+Linux) at: http://teaching.idallen.com/
| Defend digital freedom:  http://eff.org/  and have fun:  http://fools.ca/

Plain Text - plain text version of this page in Pandoc Markdown format


Campaign for non-browser-specific HTML   Valid XHTML 1.0 Transitional   Valid CSS!   Creative Commons by nc sa 3.0   Hacker Ideals Emblem   Author Ian! D. Allen