Re: legal notation ... was Re: Beyond 64K

---------

David A. Roth (david@roth-music.com)
Thu, 2 May 96 11:57:03 EST


In Regards to your letter <199605012113.OAA25831@astro.West.Sun.COM>:
>
> >> 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.
> >>
> >
> >It some times does... for instance, in my DB world a 605 error is a
> >really bad error... the same seems to happen with the FAQ... the
> >question's number gets a meaning attached to it: "oh yeah, that's
> >Q4.7 and posters start referring to it as "Q4.7"...
>
> Another example: If your FAQ is split by the Ohio State server, it gives
> its own number to each piece. If you add a question in the middle, the
> URLs change for all later questions. Anybody who has pointers into the
> middle of your FAQ has to update all of their references.
>
> Richard M. Mathews The human body can remain nude and uncovered and
> richard@west.sun.com preserve its splendor and its beauty.
> -- Pope John Paul II
>

This is just an idea, I've not done this:

What about putting the FAQ you are writing into a database. Something simple
like Clarisworks, where the index number is generated by the report printing program
(output to an ASCII file of course). Then the questions could be in it's own field
from the answers, this way the table of contents could be generated without having to
copy and paste the questions. It was labor to change the wording in a question, only
to find out that I forgot to update the table of contents or the other way around.

As for the numbering scheme, isn't it a carry over from UNIX's NROFF which at times
makes me wonder if I shouldn't be getting NROFF for the Mac and do the FAQ this way. :-
) I am using Microsoft Word for word processing, it would seem that I should be able
to use its table of contents function to handle the FAQ table of contents and have it
relate to the question.

What I ended up doing was coding the FAQ in HTML and then saved a text version through
Netscape. This worked better than using lynx to do this. The mailtos got messed up in
lynx which is understandable since I think it is a Netscape-ism.

I agree that changing index numbers could be a problem after certain sections are known
for specific questions. To insert between and not mess up numbering what about adding
an additional point number, like so:

1.5) Well known question which contains the meaning of life?
1.5.1) New burning question goes here!
1.6) Why is pizza a fast-food when it takes 30 mins for delivery?

I have to admit it looks a little strange. Perhaps this would make it look better:

1.5.0) Well known question which contains the meaning of life?
1.5.1) New burning question goes here!
1.6.0) Why is pizza a fast-food when it takes 30 mins for delivery?

This way the known questions of 1.5 and 1.6 could still be refered to?

David



[ 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