I like the idea of a "brochure-size" introduction to Struts, and a
"quick-start" installation guide. I think this might make a useful
preamble to the User Guide.
My favorite part is where you say:
"Your company has decided"
I think this would make a nice focal point for an introduction. After
all, the framework (like all applications) is really suppose to be
solving a given set of problems. But right now we seems to assume that
everyone knows what problems MVC is trying to solve, and go off from
there.
So, I'm thinking starting out with something like
"Your Web team wants add a new section to the site" ...
"Your team leader decides that Scriplets are a Bad Thing" ...
"Your Web Application must be internationlized" ...
"Your application must be accessible to everyone using anything from
anywhere" ...
"Your application must be J2EE compliant and make good use of Enterprise
Beans" ...
I could try refactoring the draft, if you agree.
-Ted.
