FAQ formats

---------

Yisrael Hersch (hersch@silicom.co.il)
Wed, 12 Jul 1995 10:36:00 -0200


Hi,

IMHO, one important consideration that is being overlooked with all of
this talk about FAQ formats, is getting started. The subject if
standards can be (and usually is) intimidating to a beginner. Our
primary goal should be to ensure that the newbie doesn't get frightened
off. What we don't want to do is scare away a potential FAQ
author/maintainer (read: contributor of knowledge to the network
community) by spewing forth a bunch of jargon and rules. Even if the
standards aren't binding, the newcomer will be afraid that he/she is
"doing something wrong."

Remember, everyone has their own priorities and outlooks. For example,
I'm kept very busy working on my FAQs. I would LOVE to html'ize them,
but I simply don't have the time. And, in my case, I need extra time to
learn how to do it altogether. I imagine that someday I'll get it done,
but meanwhile, my articles fill a need now.

In addition, I chose a format for my FAQs, and I stick to it. This
format works well for me, and I've had no complaints. If I had to use
another format, well, maybe I wouldn't bother (or maybe I would).

Remember, FAQ writing isn't just for gurus. We want everyone to become
involved, to participate, and contribute. Let's not spook anyone -
rather we should lead them by the hand to help them get acclimated.

Russ Hersch



[ Usenet Hypertext FAQ Archive | Search Mail Archive | Authors | Usenet ]
[ 1993 | 1994 | 1995 | 1996 | 1997 ]

---------

faq-admin@landfield.com

© Copyright The Landfield Group, 1997
All rights reserved