db-jdo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michelle Caisse <Michelle.Cai...@Sun.COM>
Subject Re: Spec pages for annotations
Date Sat, 16 Jun 2007 01:41:47 GMT
Hi Craig,

This looks good and is appropriate for the spec, though it is not nearly 
as user friendly as the JPOX annotation doc page 
http://www.jpox.org/docs/1_2/jdo/annotations.html. The more compact 
tabular format makes it much easier to scan and find information.  Maybe 
you could add some tables at the end of the chapter, time permitting.

How are the xml metadata overrides supposed to work?  Globally, within 
jdo/orm sets, element by element ...?

-- Michelle

Craig L Russell wrote:

> I'm thinking of concentrating my energy in making sure the javadoc  
> for annotations is correct and then publishing the spec taking the  
> information directly from the sources. Please take a look at the  
> attached sample and see if this looks like a good way to present the  
> information.
> Between the section heading and the source code I would add any notes  
> or comments.
> There are other, more labor-intensive, ways of presenting this but I  
> need to make sure the javadoc is correct anyway.
> Please let me know your thoughts...
> Craig
> Craig Russell
> Architect, Sun Java Enterprise System http://java.sun.com/products/jdo
> 408 276-5638 mailto:Craig.Russell@sun.com
> P.S. A good JDO? O, Gasp!

View raw message