On 7/21/06, Wendy Smoak <[EMAIL PROTECTED]> wrote:
On 7/21/06, Apache Wiki <[EMAIL PROTECTED]> wrote:
> Dear Wiki user,
>
> You have subscribed to a wiki page or wiki category on "Struts Wiki" for
change notification.
>
> The following page has been changed by MichaelJouravlev:
> http://wiki.apache.org/struts/StrutsDocComments
Thanks, Michael. :) The wiki looks great. Are there any pages you
think should be linked to from the xdoc?
My goal is to move as much information from wiki to official docs, and
then to tidy wiki up. I want to prepare StrutsDocComments in a way so
it can be reviewed by Struts committers as pieces of real
documentaion before incorporating this information into xdoc.
http://www.devx.com/Java/Article/31921
"Something else that appealed to me was the Stripes documentation.
Like the framework itself, it was clear, clean, and concise. The tag
library docs and API were well documented, and just about every
feature of the framework had sample code. This excellent
documentation, along with the ability for me to capitalize on my
existing Struts knowledge made me confident I could quickly get up to
speed with the Stripes framework."
I would really like to rewrite the whole User's Guide, but this is too
much of a job, and someone would have to proofread it after this
anyway ;) So I will try to incorporate wiki information into the
Manual, along with the pictures of course.
Struts does not really have a style guide. There are some practices. I
would like to generalize Struts workings by using more generic terms
like "web resource" instead of "action class" or "view" instead of
"JSP page". On the other hand I would like to suggest users a limited
set of best (or at least common) practices, so they would not wander
between countless possibilities. Look at ASP.NET, there is very
limited choice of how things are done, but users are in fact happy.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
