April 22nd, 2010

Email tip: When asking for help with a problem, also mention what you've already tried

When you ask a question, you should also mention what steps you’ve already taken when attempting to solve it on your own. First of all, it saves the people who decide to help you with your problem from exploring lines of investigation which you’ve already tried (and which you know don’t work). “I tried setting the timeout to 60 seconds before issuing the call, but it still failed with the error ERROR_NETWORK_UNREACHABLE.” Second, it cuts down on noise on the discussion list. — Try setting the timeout to a higher value.I already tried that; it didn’t work.” Third, it demonstrates that you cared enough about the problem to try to solve it yourself. It’s surprising how many questions come in from people who didn’t even make the slightest effort to solve their problem on their own. “When I issue the command show active, it shows the active tags. How do I filter it to show only active tags that I created?” — This is explained in the online help: show active -?. If the online help is unclear, please describe what you’re having trouble with and we’ll work to improve the documentation. “Thanks! The explanation in the help is just fine.”

(Yes, that was an actual response.)

Topics
Other

Author

Raymond has been involved in the evolution of Windows for more than 30 years. In 2003, he began a Web site known as The Old New Thing which has grown in popularity far beyond his wildest imagination, a development which still gives him the heebie-jeebies. The Web site spawned a book, coincidentally also titled The Old New Thing (Addison Wesley 2007). He occasionally appears on the Windows Dev Docs Twitter account to tell stories which convey no useful information.

0 comments

Discussion are closed.