I vote for number 1 to keep the site separate from the code as a practical issue for managing the Derby documentation.
In other email, Andrew <[EMAIL PROTECTED]> asked: > Are there source files for the docs, which are then generated by > forrest? If so, I would think the repository would look something like: The 6 Cloudscape manuals were converted for Derby into a format consumable by forrest, so initially I'm including them in the Derby site itself (http://incubator.apache.org/derby) -- in fact I just checked 5 of the manuals into the repository, where they await our Rodent of Unusual Size's magic incantation to become visible on the site itself. But instead of one file per book, they are organized into many files per book. forrest consumes the files in the src tree and spits out html files into the build tree -- and the result is so very many files that the Derby community may want to revisit this later. I initialized the site with the default forrest structure -- and this too could be revisited later. -jean On Fri, 2004-08-20 at 09:52, Daniel John Debrunner wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > The import of the derby code is looming; it would be nice to have a > decision about the repository structure. So let's measure consensus the > Apache way and vote on it. :) I think that we can collate the results > next Monday (8/23); our community is still small enough that we don't > need to wait a long time to close the vote. > > [ ] Option 1: Keep the code and site pages in separately-versionable > trees ( derby/site/{trunk,tags,branches}/<pages> and > derby/code/{t,t,b}<code> ) > > [ ] Option 2: Put all things Derby into a single tree > ~ ( derby/{trunk,tags,branches}/{<code>,<pages>} ) > > > Dan. > -----BEGIN PGP SIGNATURE----- > Version: GnuPG v1.2.5 (MingW32) > Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org > > iD8DBQFBJixEIv0S4qsbfuQRAsLgAKCPsTWhm56KzE3/szQEJOZsyHPeXQCgvNaG > xO8CocfgPoo0i3i+Azdwbc4= > =U+Z1 > -----END PGP SIGNATURE----- >
