I should have thought about this ... stupid me ... Thanks.

-Vincent

> -----Original Message-----
> From: Peter Donald [mailto:[EMAIL PROTECTED]]
> Sent: 16 January 2002 23:38
> To: Jakarta General List
> Subject: Re: Managing project documentation (release vs CVS versions)
?
> 
> The "recomended" solution for this is to use a branch. ie When you
make a
> release you also branch at same instant. Then if you need to update
the
> current web docs you modify them in the branch, then update the
website
> (which is using last branch released). If you need to update the docs
for
> the
> current CVS then you do it in the main trunk/HEAD revision. When
needed
> you
> merge the branch back into the main trunk.
> 
> However I don't know of any projects that do this except for ant.
> 
> It may also require a bit more CVS savvy that normal but should be
> possible
> to do if that is what cactus/whatever needs.
> 
> On Thu, 17 Jan 2002 10:34, Vincent Massol wrote:
> > Hi,
> >
> > I have always been pondering how to best manage the following.
Should
> > there be 2 web sites per project : one for the latest release
> > (containing docs + javadoc corresponding to the latest release) and
one
> > for nightly builds (containing docs + javadocs corresponding to the
> > latest code) ?
> >
> > When I work on a new feature that I want to document, I cannot
document
> > it in the xdocs/ directory because next time I change something for
the
> > web site and I want to make that change visible, it will also
contain
> > the new feature documentation. However, that feature is only present
in
> > CVS (not released yet) and users will have trouble understanding why
> > this feature does not work with the code they downloaded. Of course,
I
> > could have a header that says "WARNING: Feature only available in
CVS"
> > but it is awkward. Another solution is to have 2 xdocs directory but
> > again this is awkward ...
> >
> > Any idea ? How are other projects doing this ?
> >
> > Thanks
> > -Vincent
> >
> > _______________________
> > Vincent Massol
> > OCTO Technology UK Ltd
> > www.octo.com
> > [EMAIL PROTECTED]
> > Tel: (020) 8996 9540
> 
> --
> Cheers,
> 
> Pete
> 
> *------------------------------------------------------*
> | "Nearly all men can stand adversity, but if you want |
> | to test a man's character, give him power."          |
> |       -Abraham Lincoln                               |
> *------------------------------------------------------*
> 
> --
> To unsubscribe, e-mail:
<mailto:[EMAIL PROTECTED]>
> For additional commands, e-mail:
<mailto:[EMAIL PROTECTED]>
> 




--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to