> I'm a new FAQ maintainer (comp.databases.sybase) but my approach in
> maintaining the FAQ was to do it in HTML and use tools (lynx) to
> convert it back to text. This way I tend to not get bogged down with
> renumbering and the like...
and separately wrote:
> [...] when I first considered putting the
> Sybase FAQ together I thought I would be able to use the HTML
> numbering directive: <OL> but I remember now hitting the problem of
> sections:
>
> Anyway, what I do now is only add questions to my sections... heaven
> forbid that I have to shuffle a section about.
Pablo, I had dealt with exactly the same problem, as I'm sure many of us
had. I finally went with <UL> (Unordered List), but I include a number
with a code associated with the section. For instance, for the section
on User issues, my questions are numbered U1, U2, etc. For the section
on Manager issues, I use M1, M2, etc. This way I might rearrange the
sections without having to renumber *all* the involved sections.
I, too, avoid adding a new question in the midst of
previously-released numbering, but lately I've felt that maybe this
goes too far. As long as the numbering is internally consistent, does
it really matter if a question's number is changed from one release to
another? I've come to think it doesn't.
En paz,
Steve, Business Objects FAQ
currently at http://pobox.upenn.edu/~thompson/busob-faq.html
-- Stephen W. Thompson, U. of PA, Data Administration, 215-898-1236, WWW has PGP thompson@isc.upenn.edu URL=http://pobox.upenn.edu/~thompson/index.html
[
Usenet Hypertext FAQ Archive |
Search Mail Archive |
Authors |
Usenet
]
[
1993 |
1994 |
1995 |
1996 |
1997
]
© Copyright The Landfield Group, 1997
All rights reserved