I sent this by mistake to Steve alone, so he can stop reading now
itself. ;-)
Most of you already know all this but I guess many new maintainers
like me who can potentially benifit from this.
>FAQ list, I'm adding "Additional links" sections at the end of
>certain questions, and many of these links will point at verbatim
I think this segues very well into a definite weakness of traditional
faqs - they are text documents and people seem to believe you have to
begin at the beginning and go to the end and then stop. ;-)
The fact that they are not traditional primers where you are expected
to read everything seems to escape most people - including me.
Let's look at my experience with your faq, for example. Because your faq
is available in one large file, I happily downloaded it and kept it aside
WITHOUT browsing your faq on the net.
I am by no means much good as a C programmer. But even so, much of what
I did read in your faq was already known to me. Not because I am good,
but because the questions I did read were asked by absolute beginners.
I am sure, no, know for a fact that there is lots I can learn from
your faq. But there is always something else to do that makes me postpone
reading it.
Heck, many a times when I went to my fav. bookshop, I was severely tempted to
buy the book version of your faq. But limited student budget (and now
programmer budget) meant that I decided to buy something else.
- But I promise to eventually buy it. Honest injun!
What does this post have to do with attributing quotes? Damn if I know,
but I thought I should share my reading experience of a truly great faq
with fellow maintainers - even though what I have to say is probably
already known to you. ;-)
There are different classes of readers who are going to read our faqs,
and not everything in our faqs will be of interest to every one of our
readers.
This means webbification of any good/useful faq is unavoidable ;-)
P.S. Steve's CLC faq is already HTMLized, all I have to do is get on the web
and read it. ;-)
*************************************************************
To unsubscribe send a message to majordomo@faqs.org as
unsubscribe faq-maintainers fill-in-your-email-address-here
*************************************************************
[
FAQ Archive |
Search FAQ Mail Archive |
Authors |
Usenet References
]
[
1993 |
1994 |
1995 |
1996 |
1997 |
1998 |
1999 |
2000
]
© Copyright The Internet FAQ Consortium, 1997-2000
All rights reserved