Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
Reply-To: tomcat-dev@jakarta.apache.org
Message-ID: <3B4C6248.2080706@stinky.com>
Date: Wed, 11 Jul 2001 07:27:20 -0700
From: Alex Chaffee <guru@stinky.com>
Reply-To: alex@jguru.com
Organization: jGuru / Purple Technology
User-Agent: Mozilla/5.0 (X11; U; Linux 2.4.5 i686; en-US;
 rv:0.9.1) Gecko/20010608
MIME-Version: 1.0
To: tomcat-dev@jakarta.apache.org
Subject: Re: [DOC] TOC - thoughts
References: <NEBBKCJBPLLPNFMKLPAJCEDFDIAA.rslifka@home.com>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

Rob S. wrote:

> There is a WHACK of info in that TOC.  Your copyright is well-deserved =)
> 
> First off, I think we should have an ultra-quick install guide.


Until there's an ultra-quick install script, there can't be a ultra-quick 
install guide. For 3.x at least, there are so many different options, 
especially when you start plugging in to Apache, that I don't think it's 
possible.

> PI.1.1:  I agree with the "big picture" view of things, but from what's
> there, it almost looks like you're explaining the parts that I as an admin,
> would expect to see in the installation documentation.  Was there something
> more to this section than a description of Tomcat's internal layout?


Not internal, but architectural -- like

Apache               JVM
                       Tomcat
                        Connector (port 8080)
   mod_jk ---------->   Connector (port 8007)
                        Web Applications
                         example
                         mylittlewebapp

Or whatever...

> PI.1.2:  Agree with comments, remove to appendix. 


OK, done.

> PI.2.1:  I love pictures!  Some nice diagrams in here would go a lllong way.
> Not sure about the "choose OS" or "install Java" sections.  I mean, there's
> catering to the LCD and there's catering to the LCD...


These would just be a few sentences, mostly saying how Tomcat is 
platform-neutral.  However, you do need to make sure JAVA_HOME is set (or at 
least know what it is if the script can't find it) etc.


> I think a lot of PI.2 is overkill, and some unnecessary, dependant upon the
> implied length of the sections from  the TOC I suppose...  I mean one or two
> sentences to "downloading JDK", sure, but more than that?  Definitely more
> suited to a book than "good enough" docs ;)


Right, this doc started life as a book outline for a book I may yet write. I 
like outlining to great detail... It saves me from having to think too much 
later. I'll leave it in for now as a placeholder, but I expect it'll remain 
empty for a while.


-- 
Alex Chaffee                       mailto:alex@jguru.com
jGuru - Java News and FAQs         http://www.jguru.com/alex/
Creator of Gamelan                 http://www.gamelan.com/
Founder of Purple Technology       http://www.purpletech.com/
Curator of Stinky Art Collective   http://www.stinky.com/