The Answer Gang's Posting Guidelines
by Ben Okopnik
The Answer Gang is a mailing list run by the Linux Gazette. When you
send us a question, it is presented to all the members of the list, and
may be answered by any of them - or not. We are a bunch of volunteers,
each with their own interests and abilities; whether you get answered or
not depends on how well you engage and match both of those. There are no
guarantees of any sort - but people who pose interesting questions, especially
those of broad scope (i.e., those that would be of interest to more than
just one or two people), as well as folks who are pleasant, polite, and
have a sense of humor are not likely to be ignored. Spammers and flamers
will be either ignored, laughed at, and/or lampooned (a number of the Gangsters
have a wicked sense of humor.)
The following material describes the things that you need to do when
posting to TAG in order to maximize the chances of getting meaningful replies
to your inquiry. This should also prevent you from getting laughed at for
being lazy and trying to have others do work that you yourself should be
doing. It draws heavily on Tad McClellan's "Posting Guidelines for comp.lang.perl.misc"
<http://mail.augustmail.com/~tadmc/clpmisc/clpmisc_guidelines.text>
and the "Netiquette Guidelines" RFC
<http://andrew2.andrew.cmu.edu/rfc/rfc1855.html>
BEFORE POSTING
You Must
- Check the LG and TAG
FAQs to see if they contain an answer to your question
- Check the list
of HOWTOs for anything relevant - these offer detailed coverage of
many Linux tasks
You Really, Really Should
- Search previous issues of LG for relevant
answers
If You Like
- Check Other Resources (books, Google!/Linux,
etc.)
As you would expect, The Answer Gang's discussions are usually technical
in nature; hence, there is a strong need to observe conventions for conduct
in these discussions. Following the guidelines set out below will save
time and effort for everyone involved, and will make answering your question
much more convenient - which would also make it more likely to be answered.
There can be hundreds of messages in TAG in any given month, and we all
must decide somehow which ones we are going to answer. Your post is in
competition with all the other posts. You need to "win" before a person
who can help you will even try. Here is how to win the "TAG lottery":
POSTING TO TAG
-
Question should be about Linux, or of interest to Linux community
The Linux Gazette has a rather obvious and clearly stated purpose;
our target readership is the Linux community. We may post humorous pieces,
or "spam slams", or other non-Linux content - but in general, The Answer
Gang is here to answer Linux-specific questions. We don't usually give
out advice on cooking rhubarb, passing tests in American history, or making
your Wind*ws program work... actually, we have done all of those
in the past, but relying on it would be just plain silly. Confine your
questions to Linux-specific or Linux-related content.
-
Carefully choose the contents of your Subject header
You have 40 precious characters of Subject in which to make your first
impression. Spend them indicating what problem we can expect to find in
your query. Don't waste them indicating "experience level" (guru, newbie...)
Don't waste them pleading (please read, urgent, help!...) Don't waste them
on non-subjects ("Linux question", "Could I ask a question?"...) Part of
the beauty of Net forum dynamics is that you can contribute to the community
with your very first post! If your choice of subject leads a fellow searcher
to find the thread you are starting, then even asking a question helps
us all.
-
Beware of saying "doesn't work"
This is a "red flag" phrase, one that gives no useful information and
tends to annoy the people who are trying to help you. If you find yourself
writing that, pause and see if you can't describe what is not working without
saying "doesn't work". That is, describe how it is not what you want. Try
to explain the problem to another person using only words (i.e., don't
show
it to them - just describe it.) If they can understand what you mean, write
down the explanation you used and send it to us!
-
Use an effective follow-up style
When composing a follow-up, quote only enough text to establish the
context for the comments that you're going to add. Don't quote the entire
article; instead, intersperse your comments following the sections
of quoted text that your comments apply to. Failure to do this is called
"Jeopardy" posting because the answer comes before the question. Reversing
the chronology of the dialog (putting your response before the quoted text)
makes it much harder to read and understand; some people won't even bother
reading a post written that way (the same goes for "h4x0r"-style postings
from "k3wL d00dZ".) For more information on quoting and follow-up style,
see <http://www.geocities.com/nnqweb/nquote.html>
-
Provide enough, but not too much information
(Heather Stern "The EditorGal"'s addendum, with modifications)
Too Much Info: Where you bought the computer and whether
you still have a receipt. What color the case is. Your passwords or anything
else you wouldn't discuss in the bookstore or at a picnic.
Not Enough Info: "So I plugged everything in but it doesn't
work."
Questions whose answers (from you) would give us enough to run with:
Plugged what in?
What did you expect to happen?
What did it do instead?
What were the exact error messages?
What have you changed since then?
Where does Linux come into the puzzle? (feel
free to guess)
Which Linux flavor?
Which version of the problem software package
(you did upgrade to the latest one, right?) are you using?
-
Do not post binaries, HTML, or MIME
Email is a text only medium, and plain text is something that
any mail program can read. Don't post Word documents, vcards, HTML, or
MIME (MS Outlook does this by default; here are the instructions
for turning that off). Many people will not be able to easily read your
post, and thus will not bother. Binary attachments sent to The Answer Gang
are thrown into the trash basket without even a glance. HTML-formatted
e-mail is completely ignored by some of our members and is tolerated by
others, but is definitely a negative influence. Unnecessary MIME encoding
(it can be useful in preserving your language's character set, but mail
to TAG in a language other than English is very rare) carries the same
penalties as using HTML.
-
Remove any "confidential" notices, whether in your .signature or added
by your company's mailer (asking for your name not to be posted is OK)
Published answers benefit the entire community; this is what we do
here in TAG. If you have a "This is to be kept confidential" blurb in your
post, forget about having it answered: it just isn't going to happen. Don't
expect people to do one-on-one problem resolution unless you're willing
to pay for it. If your company automatically glues a "confidential" tag
to all your e-mail, either e-mail us from home or preface your question
with an explicit permission for us to publish. In fact, here's one you
can simply copy and paste:
-------------------------------------------------------------------------
I hereby give my explicit permission for the Linux Gazette to publish the
material in this e-mail, as well as all future responses or discussion that
result from it. This notice supersedes any and all previous restrictions.
-------------------------------------------------------------------------
(Heather Stern "The EditorGal"'s addendum)
If you know that it includes some sort of message about who it's intended
for, you can make that more clear. This example asks for anonymizing...
-------------------------------------------------------------------------
The intended recipient of this message is the readership of the world wide
webzine "Linux Gazette". Any responses or discussion with the Answer Gang
or any LG editor may be published worldwide. Please don't reveal my last
name, email address, or company.
....This notice supersedes any and all other attached restrictions. Thanks!
-------------------------------------------------------------------------
Note that we normally hide your company anyway, unless you are with a company
that helps maintain the application being discussed. But email addresses are
normally shown with Tips, in case the readers have any comments.
If you have read and followed all of the above guidelines, go ahead and
send your question to tag@lists.linuxgazette.net.
You've already done one of The Right Things by reading these guidelines;
presumably, you've already done more than one Right Thing by following
the above recommendations. If you still haven't found an answer, it should
be an interesting question indeed - and we'll be glad to hear from you!