> -----Original Message-----
> From: Ted Husted [mailto:[EMAIL PROTECTED]
> Sent: July 3, 2003 4:40 AM
> To: Struts Developers List
> Subject: Re: [PROPOSAL] Modular Struts Examples
>
>
> I'm -1 on demonstrating anything but best practices all the time. We
> made that mistake with MailReader and it has haunted us ever since.
> Unfortunately, people expect everything we do to be an example they can
> emulate.
Perhaps I overstated it when I said "best practices". What I meant is that
in a set of examples aimed at newcomers we should favour clarity over
elegance. That may mean doing things that we wouldn't do in a production
app. I certainly don't intend to demonstrate *bad* practices.
For instance, in my current set of examples there's a great deal of
duplication of code in both the actions and JSPs that would normally be
eliminated. I felt it was important for each example to be self-contained so
that users would not get confused by having to refer to many different
sections of the app to understand how the example worked.
> Meanwhile, I would be +1 on using Tiles in the Struts Examples module,
> since there is so much repetitive markup, anything else would be a bad
> practice =:)
See above on why I'm not sure this is so good :-)
My reasoning behind suggesting the two apps is that the former would provide
a minimal demonstration of the functions of Struts where the example is
self-contained and stripped down to the bare minimum in order to not confuse
the user with infrastructure details. The latter would show how to do things
"the right way" in concert with other features. ("The right way" here
meaning one of several possible right ways).
To my mind we're addressing two different issues. The first is functional;
"How do I do ...?" and the second is architectural, "What's the best way to
design ...?". My concern is that combining the two will make it harder than
necessary to understand the simple examples. If they can both be addressed
in the same application without sacrificing clarity then I'm all for it.
Steve
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
