On Dec 10, 2012, at 4:12 PM, sebb wrote:

> On 10 December 2012 21:53, Phil Steitz <phil.ste...@gmail.com> wrote:
>> On 12/10/12 1:27 PM, Ralph Goers wrote:
>>> Yes, I think you are missing something fundamental.
>>> 
>>> If you check in "the whole mess" you will never again be able to properly 
>>> build a sub-project's site with Maven.  This is because the process of 
>>> updating the site would require first doing a diff and then deleting items 
>>> that are not included in the new version. Someone created a Maven plugin to 
>>> try to do this but it is not the way I would want to go at all.
>> 
>> Sorry, I don't get it.  Why won't the following work:
>> 
>> 0) Grab all of, say p.a.o/www/commons.apache.org
>> 1) check all of that into an svn repo
>> 2) when I want to update, say, math, I generate the content locally,
>> copy it to the /math subtree and check it in.
> 
> There would need to be some extra work done to ensure that stale files
> are deleted.
> 
> For some projects, it would be possible to just delete the existing
> sub-tree and check the whole new site in.
> [This can be done as one transaction in svnmucc]
> 
> However, for sites that retain Javadoc etc. for older releases, one
> would need to re-instate that part of the tree somehow.
> 
> Given that svnpubsub immediately publishes what is checked in, it
> might be sensible to have a parallel staging directory tree where
> files can be updated piecemeal if necessary, and then use svnmucc to
> replace the live component subtree with the staging component subtree
> as part of a single transaction.
> 
> There would need to be some co-ordination between committers when
> updating commons parent, as that would affect the whole tree.
> 

Yes. This is why Logging used the extpath approach where each subproject 
commits directly to production. Each release goes to a release subdirectory 
under each subproject's directory.  Then you can just perform your maven site 
build to a local directory, copy that into the production svn location, and 
commit it.

See "Managing the subproject sites" at 
http://wiki.apache.org/logging/ManagingTheWebSite

Ralph

Reply via email to