Sunday, November 4, 2007

How To Post To A Technical Forum

Public Service Announcement

If you've been referred here...
Someone thinks you need a refresher...

If you've stumbled upon this another way...
Feel free to use this post as a reference in your forum in response to a poor post.

Be polite
- your best behavior will be rewarded

  • Stay on topics relevant to the forum.
  • Disparaging the the basis of the technical forum is counterproductive and insulting (i.e., Oracle is so stupid, why can't Microsoft make an error for SQL Server that makes sense!)
  • Don't insist on the nature of help you want (i.e., give me the answer, not links)
  • Don't post the same issue in multiple forums. It shows a lack of respect to those that have chose to member themselves at one forum over another.

Don't be lazy -
or face the wrath
  • RTFM
  • Search the Internet
  • Search the forum archives
  • Don't ever say...I searched the Internet and didn't find answer. Everyone will know your level of effort by the nature of your question.

Be interesting not pathetic
- no one really cares how bad you are hurting
  • Don't exhort responses by claiming desperation. Too often, posters use phrases such as "Urgent" or "ASAP" to imply that their time is very precious. Remember that everyone feels that way about their time. A well-written question will generally get faster and better responses than one that doesn't follow these guidelines.
  • Concentrate on making your question interesting for the reader by explaining what you've tried and how you've failed

Be explicit
- no one can read your minds
  • Post product versions, tools used, actual code
  • Use appropriate subject lines which summarize the subject of the problem. Subject lines which say "Help me" or "VB.NET" or "What to do?" only serve to give the first impression that you are too lazy to summarize your problem. Also, the Subject line and the body of your message are not intended to be a single sentence.

Be concise
- show respect for your readers' time and bandwith
  • Post only the most relevant code snippets, error messages - not entire programs or error dumps
  • Explain with no more or less words than is necessary to get the job done.

Communicate clearly
- tuck in your shirt and brush your teeth
  • Check your spelling
  • Use complete sentences
  • Don't use SMS chat-speak (i.e., plz, ur, thx, h8, etc)
  • Most professionals are extremely tolerant of language barrier-based grammar issues and intolerant of self-imposed illiteracy

Be patient -
you are getting more than you paid for, act like it
  • Insisting on quick replies to your issue only make people want you to suffer longer

Be grateful
- don't take people for granted
  • Experts in technical forums are taking out time from their busy schedules to help others in the community. If you get a helpful response from someone, you should always post the result, providing details of what you tried, and the measure of success you achieved. A simple "Thank you" can go a long way in establishing your credentials in the newsgroup.
  • Even if none of the suggestions offered were able to solve your problem, you should still be grateful and thank people for their time.
  • If you managed to solve the problem on your own, make sure to post how you solved it, so that people facing the same problem in future can search for and find the solution.

Thanks to Cerebrus for portions.

1 comments:

Destini said...

This is so perfect. So many of these concepts can be applied to a multitude of different areas of life, not just technical forums. But, of course, they work there too.

I especially like the part addressing SMS speak. Taking ridiculous shortcuts in writing is intolerable to any person who is willing to give any meaningful help.

Good work.