db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jean T. Anderson" <...@bristowhill.com>
Subject Re: [VOTE] Documentation source location in subversion
Date Fri, 11 Mar 2005 20:52:21 GMT
+1 for option 2.

  -jean

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
> 


Mime
View raw message