Rich's pageflow doc comments

[bo...@codehaus.org]

Rich--

This is all great stuff!  Since we can edit docs continuously up to
and beyond ApacheCon, once I get the baseline controls doc up, I'll
work on all of this stuff.  Things like the simple-action stuff is
excellent, and certainly will help sell beehive as a super-easy way
to build apps (round of pats-on-the-back to everyone).

I think I need to crawl the javadocs for the annotations and create a
doc explaining, with examples, the various magical things you can do.
I know it's all mentioned in the Javadocs, but it's sometimes hard to
find cool stuff when you don't even know what you're looking for. :)

A single page demonstrating the various annotations from top-to-bottom
would allow folks to read it and think "hey, I could use that for FOO,
and I could use that other thing for BAR" etc etc.  

Plus, we could recycle the examples etc directly into the javadocs
for Jpf.SimpleAction, etc.  

	-bob

Re: Rich's pageflow doc comments

[Richard Feit <ri...@bea.com>]

Cool!  An annotation reference would be excellent -- it's the kind of 
thing I'd gravitate to immediately as a user, actually.  There's a guide 
for the former incarnation of this (WebLogic Workshop XDoclet-style 
annotations) at 
http://e-docs.bea.com/workshop/docs81/doc/en/workshop/reference/tags/navJpfAnnotations.html 
.  It's incomplete wrt Beehive, and the format is different, but it 
could help as a resource.  I'm happy to get my hands dirty with this, 
too -- if there's a skeleton/partial reference page for the annotations, 
I could fill in some missing information.

Rich

bob@codehaus.org wrote:

>Rich--
>
>This is all great stuff!  Since we can edit docs continuously up to
>and beyond ApacheCon, once I get the baseline controls doc up, I'll
>work on all of this stuff.  Things like the simple-action stuff is
>excellent, and certainly will help sell beehive as a super-easy way
>to build apps (round of pats-on-the-back to everyone).
>
>I think I need to crawl the javadocs for the annotations and create a
>doc explaining, with examples, the various magical things you can do.
>I know it's all mentioned in the Javadocs, but it's sometimes hard to
>find cool stuff when you don't even know what you're looking for. :)
>
>A single page demonstrating the various annotations from top-to-bottom
>would allow folks to read it and think "hey, I could use that for FOO,
>and I could use that other thing for BAR" etc etc.  
>
>Plus, we could recycle the examples etc directly into the javadocs
>for Jpf.SimpleAction, etc.  
>
>	-bob
>
>  
>