Re: cvs commit: jakarta-site/ant/jakarta-ant/docs P4desc.html ejb.html index.html javacc.html jlink.html junit.html native2ascii.html sql.html

[Jon Stevens <jo...@latchkey.com>]

on 10/31/2000 3:30 AM, "bodewig@locus.apache.org" <bo...@locus.apache.org>
wrote:

> Checked in Ant's documentation here. The version at the site should
> contain all documentation bug fixes but not documentation for new
> features in 1.3 - so it is something you cannot find in Ant's own
> repository.

Hi, I would suggest that you check in the documentation for the actual
project within the projects directory instead of here. This CVS tree is only
for the parts of the website that are not part of any one project.

The guidelines that I follow are (using stylebook):

[PROJECT]/docs
[PROJECT]/xdocs

The xdocs directory contains the XML source for the website. The docs
directory contains the generated .html stuff.

Then, in the /www/jakarta.apache.org/ant directory, you should do a cvs
checkout of the docs directory within the jakarta-ant repo.

Thanks,

-jon

-- 
http://scarab.tigris.org/    | http://noodle.tigris.org/
http://java.apache.org/      | http://java.apache.org/turbine/
http://www.working-dogs.com/ | http://jakarta.apache.org/velocity/
http://www.collab.net/       | http://www.sourcexchange.com/

Re: cvs commit: jakarta-site/ant/jakarta-ant/docs P4desc.html ejb.html index.html javacc.html jlink.html junit.html native2ascii.html sql.html

[Stefan Bodewig <bo...@bost.de>]

>>>>> "JS" == Jon Stevens <jo...@latchkey.com> writes:

 JS> I think that keeping things in their own repositories is much
 JS> more appealing if only for permissions reasons.

You've convinced me. I'm going to rearrange this stuff today.

Stefan

Re: cvs commit: jakarta-site/ant/jakarta-ant/docs P4desc.html ejb.html index.html javacc.html jlink.html junit.html native2ascii.html sql.html

[Jon Stevens <jo...@latchkey.com>]

on 11/1/2000 11:57 PM, "Stefan Bodewig" <bo...@bost.de> wrote:

> So I saw the choice to either make a mini branch in jakarta-ant just
> for the documentation and do what you describe or commit an otherwise
> non-existent version directly to jakarta-site. I've chosen the latter
> but am willing to revert (of course) if this seems more appropriate.
> 
> Stefan

Hi Stefan, thanks for the clarification of your reasoning.

I think that keeping things in their own repositories is much more appealing
if only for permissions reasons. In other words, someone who wishes to
modify the documentation in jakarta-site would need to get voted to allow to
commit in jakarta-site, not jakarta-ant. Does that make sense?

ie:

privs:

commit on jakarta-ant does not necessarily allow for commit on jakarta-site.
So, it would be in your users (on jakarta-ant) best interest to be able to
commit to the repo without needing to get commit privs for jakarta-site.

thanks,

-jon

-- 
http://scarab.tigris.org/    | http://noodle.tigris.org/
http://java.apache.org/      | http://java.apache.org/turbine/
http://www.working-dogs.com/ | http://jakarta.apache.org/velocity/
http://www.collab.net/       | http://www.sourcexchange.com/

Re: cvs commit: jakarta-site/ant/jakarta-ant/docs P4desc.html ejb.html index.html javacc.html jlink.html junit.html native2ascii.html sql.html

[Stefan Bodewig <bo...@bost.de>]

>>>>> "JS" == Jon Stevens <jo...@latchkey.com> writes:

 JS> Hi, I would suggest that you check in the documentation for the
 JS> actual project within the projects directory instead of
 JS> here.

It is there and I totally agree with you - in the general case.

The problem here is: The documentation I've checked in at jakarta-site
is the documentation for Ant 1.2 + bug fixes of the documentation. At
the same time the version in Ant's repository already holds changes
that don't apply to 1.2 (but to the new 1.3).

So I saw the choice to either make a mini branch in jakarta-ant just
for the documentation and do what you describe or commit an otherwise
non-existent version directly to jakarta-site. I've chosen the latter
but am willing to revert (of course) if this seems more appropriate.

Stefan