Here's my initial understanding of the forrest convention.  When you are in
a single howto (possibly in a subdir), there are 2 applicable rules:

1. if there is only one howto, then the book.xml should only reference the
howto index.  forrest has an example of this at
http://xml.apache.org/forrest/community/howto/cvs-ssh/howto-cvs-ssh.html.
2. if there are multiple howtos, then the book.xml should reference the
howto index, and all the howtos at that level.  forrest has an example of
this at
http://xml.apache.org/forrest/community/howto/xmlform/howto-xmlform.html

If this is accurate, then you made the right decision.  Since there is only
one howto (tomcat), then the book.xml should only reference the howto index.
I guess I was assuming that there'd be other howto's at the tomcat level...
hence my inclusion of the tomcat.html link in the book.xml.

But I think you made the right decision.  No need to add multiple links
until there are multiple howtos.

thanks again.
dave

-----Original Message-----
From: Vladimir R. Bossicard [mailto:[EMAIL PROTECTED]
Sent: Friday, November 22, 2002 9:38 AM
To: [EMAIL PROTECTED]
Subject: Re: cvs commit:
xml-xindice/src/documentation/content/xdocs/community/howto/installation
book.xml


>       I'm not arguing that it should be one way or the other.  I thought I had
> done it the proper way, but as a newbie forrester, I am uncertain.

I'm not a Forrest guru, I just followed the Forrest website
<http://xml.apache.org/forrest/community/howto/index.html>.

I think the concept is that when you select a how-to, you don't see the
references to the others.

-Vladimir

--
Vladimir R. Bossicard
Apache Xindice - http://xml.apache.org/xindice



Reply via email to