db-jdo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cbeams <cbe...@gmail.com>
Subject Re: Apache JDO : site
Date Sat, 29 Sep 2007 19:24:47 GMT
+1 on moving these docs

- Chris

On Sep 29, 2007, at 8:54 AM, Craig L Russell wrote:

> Hi Andy,
>
> On Sep 29, 2007, at 7:04 AM, Andy Jefferson wrote:
>
>> I propose moving a number of JPOX docs general to JDO onto Apache  
>> JDO's site.
>
> Good idea.
>
>> To be more specific, we (JPOX) have some docs under
>> http://www.jpox.org/docs/jdo/jdo_overview.html
>> some of which need updating (some of the figures are outdated or  
>> could be
>> cleaner), but all are based around explaining the JDO spec to  
>> users (since
>> the average JDO user doesnt go near the spec, but may respond  
>> better to
>> pretty flow charts and sample code). They would sit better over on  
>> Apache JDO
>> IMHO.
>
> I agree.
>>
>> Issue 1 : Anyone against this move of content? Any issues, or any  
>> of the docs
>> in that section not suitable ?
>
> They need to be reviewed for accuracy. I saw that the JDO vs. JPA  
> could use some work. And we could add some details like comparing  
> to Hibernate in the Why JDO section.
>>
>> Issue 2 : by moving these docs over, the Apache JDO site will  
>> start to get
>> much more content than it currently has, and when this happens it  
>> may be
>> necessary to add top-level navigation as well as the current side  
>> navigation,
>> or to add hide/show features to the side navigation. Apache JDO  
>> currently
>> uses some "Anakia" (?!) to generate the docs which I know little  
>> of (except
>> that its Velocity underneath), so why is this used instead of  
>> Maven1 "site"
>> plugin (which is also Velocity) ? Any objections to using Maven1  
>> "site"?
>
> When we looked at the site plugin, it had limited ability to change  
> the "skin" and navigation features but that might have been because  
> we didn't look hard enough.
>
> I have no strong feelings about the tooling we use.
>
> Craig
>>
>>
>> -- 
>> Andy  (Java Persistent Objects - http://www.jpox.org)
>
> 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!
>


Mime
View raw message