struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jonathan Asbell" <jasb...@i-2000.com>
Subject Re: *TED* - round 2 of documentation
Date Fri, 06 Jul 2001 11:55:23 GMT
Hello Ted.  I gave this documentation to the other developers in my group
who do not know about Struts, and they said that they now understand what
Struts is and how to approach using it.  They got lost in the "Struts
Components" section because they didnt have a picture to accompany the
explanation, and because they were unfamiliar with Struts.  They said that
the section "How it all works" clarified how Struts behaves.
    The point being that the impedance from trying new tools lies in the
time necessary to understand and configure it.  Living in New York is great
because it is the ultimate test for when something is too complicated:
People wont take the time to use it.  This type of outline gets would be
users/developers started quick.  In a few pages they know what Struts is,
what it needs to run, and how it functions.  Now they can go on, install,
configure and develop with Struts with the user guide and this paper in hand
and feel fairly confident in developing with it.

----- Original Message -----
From: "Ted Husted" <husted@apache.org>
To: <struts-dev@jakarta.apache.org>
Sent: Friday, July 06, 2001 5:03 AM
Subject: Re: *TED* - round 2 of documentation


> I think the first two sections might make for a nice product sheet for
> developers to pass along to the suits. Like a hand-out you might pickup
> at a tradeshow. A PDF would be very cool here. (I have the distiller and
> so can make those here.)
>
> I like the idea of a Struts Components section, but I'm not sure where
> it would go. It seems like it should be placed early in the
> documentation outline, but the current User Guide focusses on the MVC
> architecture, which makes a Struts component overview a better fit at
> the end, perhaps as Chapter 5. Dunno.
>
> Personally, I'd like to see our entire approach to installation turned
> upside down, so that people are encouraged to download the WARs first
> and install those. Then do some development using only the Struts.jar,
> and, finally, (if you really, really have to ;-) build Struts from
> scratch.
>
> -- Ted Husted, Husted dot Com, Fairport NY USA.
> -- Custom Software ~ Technical Services.
> -- Tel 716 737-3463.
> -- http://www.husted.com/about/struts/
>


Mime
View raw message