On Tue, 12 Nov 2002 11:18, you wrote: > I have thought of three guides to write, but am not sure if they would be > helpful, or which to do first. Any suggestions? > > * Multiple Site Howto -- How to organize classes and actions so that a > single turbine instance can serve multiple sites that may need to share > common functionality
The above Howto might be useful to some people, but IMHO there are higher priorities; see below. If you look at the Torque documentation, they currently have a Tutorial, a User Guide and a Developer Guide as well as various Howtos Guides. I think this would work well for Turbine. I personally think that the current Turbine 2.x documentation is spread out across too many Howto documents and that many of these could be compiled into a single comprehensive User Guide separated into appropriate chapters. > * Service Howto/Introduction -- What services are, why they are nice, and > how to write them I think it would be good if Turbine Services took up a chapter in the Turbine 2 User Guide. See the existing service documentation for a place to start: http://jakarta.apache.org/turbine/turbine-2/apidocs/org/apache/turbine/services/package-summary.html http://jakarta.apache.org/turbine/turbine-2/services.html > * Non TDK Howto -- I found the TDK confusing because it did a bunch of > stuff that I didn't necessarily want. So I learned about Turbine by > removing everything, and putting it back in as I needed it. This document > would be a "tour" in the form of setting up an example app without using > the TDK. This would be the Turbine 2 Tutorial and would come with a sample application, similar in structure to the Torque Tutorial. I think this would probably be the most important document to write. If we had a Tutorial, we would no longer need a TDK. I was in the process of migrating my Turbine 2.1 application over to Turbine 2.2-RC1 a couple of weeks ago, and I began writing a Turbine 2.1 to 2.2 Migration Howto. Unfortunately, work has become very busy so I haven't had a chance to complete it yet. Paul Smith had also volunteered to rewrite/update the TDK Howto to reflect the differences between TDK-2.1 and TDK-2.2, but he is waiting for the final release of TDK-2.2 before he starts. Regards, -- Rodney -- To unsubscribe, e-mail: <mailto:turbine-user-unsubscribe@;jakarta.apache.org> For additional commands, e-mail: <mailto:turbine-user-help@;jakarta.apache.org>
