New doc release? Yes, no?

[Michael Rensing]

On Wed, 2003-08-27 at 10:25, Jon Lapham wrote:
> Chris Lyttle wrote:

> Concerning Michaels FAQ update, that could go in but I'm wondering what 
> you think about him using <sect2>'s around each question?
> 
> Take a look at the web pages:
> http://www.gnucash.org/docs/v1.8/C/gnucash-guide/appendixb.html
> 
> I'm not sure I like it.  On one hand, it is nice to see all the 
> questions in the chapter contents... on the other hand, the Table of 
> Contents for the whole document will have 1 entry for each question, 
> which seems like it isn't appropriate.  Imagine when we have more 
> questions there.  What do you think?

I'm a bit ambivalent myself for exactly the same reasons. If people
don't like having all the questions in the TOC, I can certainly go to
the ordered list without too much hassle.

I do like the list of questions, though. How about using an ordered list
with a hyperlinked list of questions at the beginning of the FAQ?

> The alternative, of course, is to change to an ordered list.

AFAICT, it would look almost the same, but the questions wouldn't be in
the TOC.

-- 
Michael Rensing