[Opensource] Expresso 4.1 Documentation Promotion

[Geeta Ramani]

Hi all:

In an effort to make a contribution to the doc enhancements that Sandra has
mentioned below and in other notes, I looked at the "Expresso Controller
Objects" document under the "Components Overview" section under
"Documentation". I submitted a preliminary revision which now seems to be
on-site. (Sandra, I thought you were supposed to wait till we resolved the
issues I had..! ;)

Anyways, here a couple of things I'm concerned about:
The last piece on "Controllers and EJBs" really doesn't seem ok. Especially
the bit about "Expresso Framework is supposed to have a J2EE mapping /
integration. "..Well, does it or doesn't it? I dont know, so I left it
untouched, but maybe someone on this list could clarify this?

Further, the bit about "The difference between DBObjects and EntityBeans"
seems interesting except the subsequent list doesn't seem to point out any
differences, but simply lists how an EJB is supposed to behave. I am sure
there's something of importance here: I just don't know enough either about
EJBs or about DBObjects to comment/correct.. Again, could someone explain?

Otherwise the changes I made to the earlier document were mostly cosmetic
:).. Btw, does anyone have any comment about the second statement that I
added in:  (Contrary to what may be initial expectation, a "Controller" does
not therefore extend the Struts ActionServlet.)
This is something which confused me at first, so I mentioned it.  I mean the
name "Controller" for the Expresso controller made me imagine it "ought to"
extend the Struts ActionServlet.. But I have been working with Struts only
for a couple of months, so this may just be my inexperience showing. :(
Maybe the Struts Action classes are (or should be) in fact considered "part
of" the Controller?? .. I always thought of them somehow as a liason between
the (one) big-boss (ActionServlet) Controller and the Model classes.. but
hey, I'm easy, I can change my mind..;)

I also added a definition for a "finite state machine". I thought some of us
may benifit from a review ..
I also added the "JobSecurityMatrix" Controller to the list of Controllers
included with Expresso. I lifted the "description" part right out of the
source for that class - so hopefully it isn't way off..! ;) I didn't check
on the other descriptions: don't know enough about any of them..

I guess that's it for now.
Thanks very much in advance,
Geeta

Sandra Cann wrote:

> Just wanted to post a quick update. Another worthy new documentation
> contribution was added to the site documentation onsite yesterday:
>
>         - Expresso Administrative Web Interface Guide by Tino Dai
>
> If you want to lend a hand in the documentation revisions or simply have
> some suggestions - drop me a line.
>
> Sandra
> COO
>
> _______________________________________________
> Opensource mailing list
> Opensource at jcorporate.com
> http://mail.jcorporate.com/mailman/listinfo/opensource
> Archives: http://mail.jcorporate.com/pipermail/opensource/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mailman.jcorporate.com/pipermail/opensource/attachments/20021019/1bd06fb1/attachment-0002.htm