> On Fri, Dec 15, 2000 at 01:21:04PM +0100, Stas Bekman wrote:
> > Hmm, should I add <font size=+7></font> around it? Do others find it
> > hidden?
> 
> In fact I do. Also, are the other documents being maintained? Do you
> really want users to go read the other ones?

I'm cannot tell users not to read other documents. You should ask their
respective owners whether they find their documents still unique and
whether they should stay online, since the guide has swallowed long time
ago most of the material in these, but not all of it.
 
> Another thing I observed: The Guide is becoming almost TOO big and
> unwieldly.

I can tell you that it's stable now. Most of the work done within the
existing material and no new material is added (well very little). I still
have a bunch of outstanding emails with very good info that should enter
the guide, but I didn't get to them yet.

> New people can get overwhelmed. 

New people are always overhelmed. Whether you have a little or no
documentation or too much of it.

> How about arranging the Table of Contents into Chapters and moving
> topics around a little as follows:
> 
>     1. Introduction   
>        - Incentive & Credits
>        - Overview
>        - Downloading s/w and documentation
>       
>     2. mod_perl Administration
>        - mod_perl Installation
>        - mod_perl Configuration
>        - Controlling and Monitoring the Server
>        - Choosing the Right Strategy
>        - Real World Scenarios
>        - Choosing an o/s and h/w
> 
>     3. mod_perl Programming
>        - Perl reference
>        - CGI to mod_perl Porting
>        - Frequently mod_perl Problems & Workarounds
>        - Troubleshooting Index
>        - Code Snippets
>        - Debugging
>        - Working with Apache::* modules
>        
>     4. Conclusion
>        - Getting Help and Further Learning
>        - mod_perl Advocacy
> 
> If you want I can give you patches against CVS to re-arrange the TOC as
> above.

This is planned long time ago, but I won't do anything before the book
will be completed. It's long time overdue. Once the book will be out, you
won't need the guide anymore. Believe me that the book will have a proper
TOC and organization.

Currently I cannot use your TOC since:  

1) it's automatically created 

2) your toc grouping doesn't reflect the order the chapters should be read
in, the guide is mainly a "guide" (designed for sequantial reading) and
when used as a reference the search is to be used. The chapters aren't
linked in the random order but in the predefined one.

3) your toc has omitted a few chapters.

I'll highlight the guide though as suggested by a few users in the private
emails. Also if you go to take23.org and you should, the guide is
outstanding there.

_____________________________________________________________________
Stas Bekman              JAm_pH     --   Just Another mod_perl Hacker
http://stason.org/       mod_perl Guide  http://perl.apache.org/guide 
mailto:[EMAIL PROTECTED]   http://apachetoday.com http://logilune.com/
http://singlesheaven.com http://perl.apache.org http://perlmonth.com/  


Reply via email to