db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Edward Rayl <er...@bellsouth.net>
Subject Re: [VOTE] Documentation source location in subversion
Date Tue, 08 Mar 2005 23:15:34 GMT
Andrew McIntyre wrote:

> Recently, a vote was approved that the source for the Derby  
> documentation should be XML DITA format. Details can be found in 
> these  threads:
>
> http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200502.mbox/ 
> %3c20050211180100.98392.qmail@web81608.mail.yahoo.com%3e
> http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200503.mbox/ 
> %3c20050302193138.488.qmail@web81609.mail.yahoo.com%3e
>
> These source files should now be stored in the Subversion repository.  
> Please vote on one of the following locations to store the source:
>
> 1 - in derby/code, with each branch getting its own copy of the 
> source  as applicable, in docs/src
>
> 2 - in derby/docs, a new module with a similar trunk/branches/tags  
> layout underneath to easily match the version of the documentation to  
> the corresponding code.
>
> 3 - a hybrid approach, with the source checked in to derby/code, and  
> the remaining files necessary to build the docs in derby/docs as  
> suggested here:
>
> http://mail-archives.eu.apache.org/mod_mbox/db-derby-dev/200503.mbox/ 
> %3c422A3AC1.3010100@bristowhill.com%3e
>
> After reviewing the source, which comprises almost 1100 files (nearly  
> as many as the engine!), and will have its own building requirements, 
> I  am now thinking that everyone will be happier if the docs are 
> managed  separately from either the code or the website.
>
> My +1 vote goes to option 2.
>
> andrew
>
>
>
As an end user, option 2 seems to make more sense.   I would vote for 
that as well.


Mime
View raw message