Re: FAQ formats (was: Perl HTML conversion script)

---------

Nancy McGough (nancym@ii.com)
Thu, 25 May 1995 07:05:23 -0700 (PDT)


On Thu, 25 May 1995, Chris Lewis wrote:
> } Does anyone here use digest ? (should I be using it ?)
>
> Fully RFC1153-compliant digest is _ugly_. And almost nobody uses it for
> FAQs.

I use it and I think I'm fully RFC1153 compliant. I'd appreciate
feedback on the look of my FAQs (are they ugly?), which are
accessible from:

http://www.jazzie.com/ii/writing.html

> I may be biased, but, unless you're assuming that your entire audience is
> using MIME or HTML capable newsreaders, I think the minimal format given
> is the best bang for the buck.

I completely agree! I have lots of info about writing FAQs, including
info on digest format, at my "Finding and Writing FAQs and Periodic
Postings" at:

http://www.best.com/~ii/internet/faqs.html

Please send me suggestions for improving it!

-Nancy

PS - I have a terminology question about the different formats of
each of my FAQs. Right now I use these terms:
* `plain text' is what I post
* `flat hypertext' is what the Netherlands FAQ server gives
* `hypertext with hyper TOC' is what the Ohio FAQ server gives

But I'm not sure I like the terms I'm using for the hypertext
versions, especially `hypertext with hyper TOC' - anyone have
a suggestion? Maybe something like `exploded hypertext'? Thnx.

-- 
 /\_/\                  @..@    Please make sure your host gets the  /\_/\
( o.o ) Nancy McGough  (----)   new humanities.* newsgroups. Info   ( o.o )
 > ^ <  Infinite Ink  ( >__< )  is at http://www.jazzie.com/ii/      > ~ <


[ 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