db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From scott hutinger <s-hutin...@wiu.edu>
Subject Re: [VOTE] Documentation source location in subversion
Date Mon, 14 Mar 2005 15:52:32 GMT
+1
option 2

Jean T. Anderson wrote:

> +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