openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Craig L Russell <Craig.Russ...@Sun.COM>
Subject Re: Uploading docs for 0.9.0-incubating release
Date Sun, 15 Oct 2006 19:42:36 GMT
Hi Marc,

On Oct 14, 2006, at 11:11 PM, Marc Prud'hommeaux wrote:

>
> I've gone ahead and checked in the OpenJPA manual so it is  
> available at:
>
>    http://incubator.apache.org/openjpa/docs/openjpa-0.9.0- 
> incubating/manual/manual.html

This is good, being linked from the navbar on the site.

Until we are comfortable with Confluence being both site and wiki, I  
think maintaining the site is important.

Craig
>
>
>
> On Oct 14, 2006, at 6:13 PM, Craig L Russell wrote:
>
>> More detail.
>>
>> It's not too hard to add html stuff to the site, as long as there  
>> is some anchor for them. See http://incubator.apache.org/openjpa/ 
>> javadoc.html as an example.
>>
>> The only issue is making sure folks can get to them, and that we  
>> know how to build them and make them available.
>>
>> It might be ok if only the latest release of the html manual was  
>> available via the site. If the docs are built from sources in the  
>> trunk, when you make a branch for release, then the manual is also  
>> branched and any updates in the trunk will be reflected in the  
>> site docs. The users who wanted manuals from the branch would need  
>> to have instructions on how to build them for their use.
>>
>> You might look at other Apache (e.g. Derby) projects for how they  
>> handle this.
>>
>> Craig
>>
>> On Oct 14, 2006, at 5:27 PM, Craig L Russell wrote:
>>
>>> Hi Marc,
>>>
>>> I've added the javadocs (from August; see OPENJPA-11) to the  
>>> site, not the wiki.
>>>
>>> These might need an update at some point but they are probably  
>>> 90% there.
>>>
>>> The manual stuff should probably go onto the site as well.
>>>
>>> Craig
>>>
>>> On Oct 13, 2006, at 2:45 PM, Marc Prud'hommeaux wrote:
>>>
>>>> All-
>>>>
>>>> I would like to upload the OpenJPA docs and javadocs for the  
>>>> 0.9.0-incubating to a more official location than the  
>>>> information place where they currently result (http:// 
>>>> people.apache.org/~mprudhom/openjpa/site/openjpa-project/manual/ 
>>>> index.html).
>>>>
>>>> Does anyone have any recommendations for where they should be  
>>>> put? Should I check them into the svn repository that is the  
>>>> source for http://incubator.apache.org/openjpa/ ,  or should I  
>>>> try to convert them into the wiki at http://cwiki.apache.org/ 
>>>> openjpa/ , or somewhere else?
>>>>
>>>>
>>>>
>>>
>>> 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!
>>>
>>
>> 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!
>>
>

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