db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andrew McIntyre <mcintyr...@gmail.com>
Subject [VOTE] Documentation source location in subversion
Date Tue, 08 Mar 2005 22:50:43 GMT
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