You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Hervé BOUTEMY <he...@free.fr> on 2013/09/22 01:49:25 UTC
CMS + svnpubsub explanations
I just published a documentation about CMS + svnpubsub for Maven, with schema
for global overview of the differences and synchronization points between Maven
site and components reference documentations [1]
The documentation about Maven website is expected to be complete, but
components reference documentation still needs improvements for people to
better understand how the configuration is done. It can even be subject to
discussion, since not every component uses the same process for the moment:
one of my intents by doing this documentation is to be able to discuss with
Maven devs to define our target convention. But for the moment, it is not
possible since I know a lot of people are lost in different cases (and no,
there is no CMS when we publish component reference documentation).
Please review and tell if anything is not clear
Regards,
Hervé
[1] http://maven.apache.org/developers/website/deploy-maven-website.html
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: CMS + svnpubsub explanations
Posted by Hervé BOUTEMY <he...@free.fr>.
thank you Robert for the feedback
I'll work on simplification and split of content: yes, the complete view is
more complex than expected, given the difference between main web site and
versioned component reference documentation
Any other feedback appreciated
Regards,
Hervé
Le jeudi 26 septembre 2013 20:30:03 Robert Scholte a écrit :
> Hi Hervé,
>
> when following the release procedures, I start at maven-plugin-release[1]
> After following the "Maven Project Common Release procedure" I return to
> this page again.
> The paragraph "Staging the latest documentation" didn't gave me the hint
> that it is safe to run only "mvn scm-publish:publish-scm" if the
> deployment itself failed.
> During the whole release I didn't came across the deploy-maven-website[2]
> page.
>
> I think we should split this in page in to, because from a user
> perspective the CMS publication is totally different then the publication
> as part of the build/site lifecycle.
> I was pretty overwhelmed by the amount of text and the process flow image.
>
> Robert
>
> [1] http://maven.apache.org/developers/release/maven-plugin-release.html
> [2] http://maven.apache.org/developers/website/deploy-maven-website.html
>
>
> Op Thu, 26 Sep 2013 00:12:10 +0200 schreef Hervé BOUTEMY
>
> <he...@free.fr>:
> > yes, the first issue is a svn-eu issue: I'll add a FAQ
> >
> > the second issue is more subtle: you got the solution, which is delete
> > local
> > svn checkout
> > that needs a FAQ entry too
> >
> > I'll do it tomorrow if nobody beats me at it
> >
> > notice you ran "mvn site-deploy", ie the phase, and
> > scm-publish:publish-scm
> > was bound to the phase in parent pom
> > pro: more concise and classical
> > cons: each time you run the command, the site gets generated (site phase)
> >
> > that's why I documented "mvn scm-publish:publish-scm"
> >
> > given your nice idea in install and deploy for multi-modules'
> > installAtEnd, I
> > think I should be able to integrate scm support in site:deploy
> > this would simplify the commands and configuration
> > but the site:deploy code will be more complex
> > and for the moment, I didn't have time
> >
> > Regards,
> >
> > Hervé
> >
> > Le mardi 24 septembre 2013 21:56:46 Robert Scholte a écrit :
> >> Hi,
> >>
> >> And again my site publication wasn't straight forward, but I think I'm
> >> hitting a Europe-delay issue.
> >>
> >> After running 'mvn site-deploy -Preporting' for the first time, it ends
> >> with a
> >> [ERROR] Failed to check out from SCM: The svn command failed. svn:
> >> E170000: URL
> >> 'https://svn.apache.org/repos/infra/websites/production/maven/content/plu
> >> gin s-archives/maven-deploy-plugin-LATEST' doesn't exist
> >>
> >> A couple of seconds later I get the following notification:
> >> Log:
> >>
> >> Automatic svn path creation:
> >> https://svn.apache.org/repos/infra/websites/production/maven/content/
plu
> >> gin s-archives/maven-deploy-plugin-LATEST
> >>
> >> This looks like the reason why waitBeforeTagging[1] was introduced for
> >> the
> >> maven-release-plugin
> >>
> >> Since I'm not sure if scm-publish:publish-scm will work, I decided to
> >> run
> >> 'mvn site-deploy -Preporting' again.
> >>
> >> After a lot of "svn add"'s I get the following message:
> >> [ERROR] Failed to add new files to SCM: The svn command failed. svn:
> >> E155007: 'E:\Users\Robert
> >> Scholte\maven-sites\plugins-archives\maven-deploy-plugin-LATEST\apidocs'
> >> is not a working copy
> >>
> >> By now I know that one solution is to start all over again: deleting
> >> E:\Users\Robert Scholte\maven-sites\plugins-archives and run 'mvn
> >> site-deploy -Preporting' for the third time.
> >>
> >> Now finally success.
> >>
> >> So I think we should add an optional delay to prevent the issue from my
> >> first run.
> >> I still don't understand what is the real issue with the second run.
> >>
> >> That's something about the process.
> >>
> >> The "Stage the Release"[2] chapter is missing a direct link to the page
> >> explaining how to publish the site.
> >>
> >> Robert
> >>
> >> [1]
> >> http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.h
> >> tml #waitBeforeTagging [2]
> >> http://maven.apache.org/developers/release/maven-project-release-procedur
> >> e.h tml#Stage_the_Release
> >>
> >>
> >> Op Sun, 22 Sep 2013 11:18:47 +0200 schreef Robert Scholte
> >>
> >> <rf...@apache.org>:
> >> > I will release the maven-deploy-plugin soon, so I can verify very well
> >> > if that part is complete.
> >> >
> >> > Robert
> >> >
> >> > Op Sun, 22 Sep 2013 01:49:25 +0200 schreef Hervé BOUTEMY
> >> >
> >> > <he...@free.fr>:
> >> >> I just published a documentation about CMS + svnpubsub for Maven,
> >>
> >> with
> >>
> >> >> schema
> >> >> for global overview of the differences and synchronization points
> >> >> between Maven
> >> >> site and components reference documentations [1]
> >> >>
> >> >> The documentation about Maven website is expected to be complete, but
> >> >> components reference documentation still needs improvements for
> >>
> >> people
> >>
> >> >> to
> >> >> better understand how the configuration is done. It can even be
> >>
> >> subject
> >>
> >> >> to
> >> >> discussion, since not every component uses the same process for the
> >> >> moment:
> >> >> one of my intents by doing this documentation is to be able to
> >>
> >> discuss
> >>
> >> >> with
> >> >> Maven devs to define our target convention. But for the moment, it is
> >> >> not
> >> >> possible since I know a lot of people are lost in different cases
> >>
> >> (and
> >>
> >> >> no,
> >> >> there is no CMS when we publish component reference documentation).
> >> >>
> >> >> Please review and tell if anything is not clear
> >> >>
> >> >> Regards,
> >> >>
> >> >> Hervé
> >> >>
> >> >> [1]
> >>
> >> http://maven.apache.org/developers/website/deploy-maven-website.html
> >>
> >> >> ---------------------------------------------------------------------
> >> >> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> >> >> For additional commands, e-mail: dev-help@maven.apache.org
> >> >
> >> > ---------------------------------------------------------------------
> >> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> >> > For additional commands, e-mail: dev-help@maven.apache.org
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> >> For additional commands, e-mail: dev-help@maven.apache.org
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: CMS + svnpubsub explanations
Posted by Robert Scholte <rf...@apache.org>.
Hi Hervé,
when following the release procedures, I start at maven-plugin-release[1]
After following the "Maven Project Common Release procedure" I return to
this page again.
The paragraph "Staging the latest documentation" didn't gave me the hint
that it is safe to run only "mvn scm-publish:publish-scm" if the
deployment itself failed.
During the whole release I didn't came across the deploy-maven-website[2]
page.
I think we should split this in page in to, because from a user
perspective the CMS publication is totally different then the publication
as part of the build/site lifecycle.
I was pretty overwhelmed by the amount of text and the process flow image.
Robert
[1] http://maven.apache.org/developers/release/maven-plugin-release.html
[2] http://maven.apache.org/developers/website/deploy-maven-website.html
Op Thu, 26 Sep 2013 00:12:10 +0200 schreef Hervé BOUTEMY
<he...@free.fr>:
> yes, the first issue is a svn-eu issue: I'll add a FAQ
>
> the second issue is more subtle: you got the solution, which is delete
> local
> svn checkout
> that needs a FAQ entry too
>
> I'll do it tomorrow if nobody beats me at it
>
> notice you ran "mvn site-deploy", ie the phase, and
> scm-publish:publish-scm
> was bound to the phase in parent pom
> pro: more concise and classical
> cons: each time you run the command, the site gets generated (site phase)
>
> that's why I documented "mvn scm-publish:publish-scm"
>
> given your nice idea in install and deploy for multi-modules'
> installAtEnd, I
> think I should be able to integrate scm support in site:deploy
> this would simplify the commands and configuration
> but the site:deploy code will be more complex
> and for the moment, I didn't have time
>
> Regards,
>
> Hervé
>
> Le mardi 24 septembre 2013 21:56:46 Robert Scholte a écrit :
>> Hi,
>>
>> And again my site publication wasn't straight forward, but I think I'm
>> hitting a Europe-delay issue.
>>
>> After running 'mvn site-deploy -Preporting' for the first time, it ends
>> with a
>> [ERROR] Failed to check out from SCM: The svn command failed. svn:
>> E170000: URL
>> 'https://svn.apache.org/repos/infra/websites/production/maven/content/plugin
>> s-archives/maven-deploy-plugin-LATEST' doesn't exist
>>
>> A couple of seconds later I get the following notification:
>> Log:
>> Automatic svn path creation:
>> https://svn.apache.org/repos/infra/websites/production/maven/content/ plugin
>> s-archives/maven-deploy-plugin-LATEST
>>
>> This looks like the reason why waitBeforeTagging[1] was introduced for
>> the
>> maven-release-plugin
>>
>> Since I'm not sure if scm-publish:publish-scm will work, I decided to
>> run
>> 'mvn site-deploy -Preporting' again.
>>
>> After a lot of "svn add"'s I get the following message:
>> [ERROR] Failed to add new files to SCM: The svn command failed. svn:
>> E155007: 'E:\Users\Robert
>> Scholte\maven-sites\plugins-archives\maven-deploy-plugin-LATEST\apidocs'
>> is not a working copy
>>
>> By now I know that one solution is to start all over again: deleting
>> E:\Users\Robert Scholte\maven-sites\plugins-archives and run 'mvn
>> site-deploy -Preporting' for the third time.
>>
>> Now finally success.
>>
>> So I think we should add an optional delay to prevent the issue from my
>> first run.
>> I still don't understand what is the real issue with the second run.
>>
>> That's something about the process.
>>
>> The "Stage the Release"[2] chapter is missing a direct link to the page
>> explaining how to publish the site.
>>
>> Robert
>>
>> [1]
>> http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html
>> #waitBeforeTagging [2]
>> http://maven.apache.org/developers/release/maven-project-release-procedure.h
>> tml#Stage_the_Release
>>
>>
>> Op Sun, 22 Sep 2013 11:18:47 +0200 schreef Robert Scholte
>>
>> <rf...@apache.org>:
>> > I will release the maven-deploy-plugin soon, so I can verify very well
>> > if that part is complete.
>> >
>> > Robert
>> >
>> > Op Sun, 22 Sep 2013 01:49:25 +0200 schreef Hervé BOUTEMY
>> >
>> > <he...@free.fr>:
>> >> I just published a documentation about CMS + svnpubsub for Maven,
>> with
>> >> schema
>> >> for global overview of the differences and synchronization points
>> >> between Maven
>> >> site and components reference documentations [1]
>> >>
>> >> The documentation about Maven website is expected to be complete, but
>> >> components reference documentation still needs improvements for
>> people
>> >> to
>> >> better understand how the configuration is done. It can even be
>> subject
>> >> to
>> >> discussion, since not every component uses the same process for the
>> >> moment:
>> >> one of my intents by doing this documentation is to be able to
>> discuss
>> >> with
>> >> Maven devs to define our target convention. But for the moment, it is
>> >> not
>> >> possible since I know a lot of people are lost in different cases
>> (and
>> >> no,
>> >> there is no CMS when we publish component reference documentation).
>> >>
>> >> Please review and tell if anything is not clear
>> >>
>> >> Regards,
>> >>
>> >> Hervé
>> >>
>> >> [1]
>> http://maven.apache.org/developers/website/deploy-maven-website.html
>> >>
>> >> ---------------------------------------------------------------------
>> >> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
>> >> For additional commands, e-mail: dev-help@maven.apache.org
>> >
>> > ---------------------------------------------------------------------
>> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
>> > For additional commands, e-mail: dev-help@maven.apache.org
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
>> For additional commands, e-mail: dev-help@maven.apache.org
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: CMS + svnpubsub explanations
Posted by Hervé BOUTEMY <he...@free.fr>.
yes, the first issue is a svn-eu issue: I'll add a FAQ
the second issue is more subtle: you got the solution, which is delete local
svn checkout
that needs a FAQ entry too
I'll do it tomorrow if nobody beats me at it
notice you ran "mvn site-deploy", ie the phase, and scm-publish:publish-scm
was bound to the phase in parent pom
pro: more concise and classical
cons: each time you run the command, the site gets generated (site phase)
that's why I documented "mvn scm-publish:publish-scm"
given your nice idea in install and deploy for multi-modules' installAtEnd, I
think I should be able to integrate scm support in site:deploy
this would simplify the commands and configuration
but the site:deploy code will be more complex
and for the moment, I didn't have time
Regards,
Hervé
Le mardi 24 septembre 2013 21:56:46 Robert Scholte a écrit :
> Hi,
>
> And again my site publication wasn't straight forward, but I think I'm
> hitting a Europe-delay issue.
>
> After running 'mvn site-deploy -Preporting' for the first time, it ends
> with a
> [ERROR] Failed to check out from SCM: The svn command failed. svn:
> E170000: URL
> 'https://svn.apache.org/repos/infra/websites/production/maven/content/plugin
> s-archives/maven-deploy-plugin-LATEST' doesn't exist
>
> A couple of seconds later I get the following notification:
> Log:
> Automatic svn path creation:
> https://svn.apache.org/repos/infra/websites/production/maven/content/ plugin
> s-archives/maven-deploy-plugin-LATEST
>
> This looks like the reason why waitBeforeTagging[1] was introduced for the
> maven-release-plugin
>
> Since I'm not sure if scm-publish:publish-scm will work, I decided to run
> 'mvn site-deploy -Preporting' again.
>
> After a lot of "svn add"'s I get the following message:
> [ERROR] Failed to add new files to SCM: The svn command failed. svn:
> E155007: 'E:\Users\Robert
> Scholte\maven-sites\plugins-archives\maven-deploy-plugin-LATEST\apidocs'
> is not a working copy
>
> By now I know that one solution is to start all over again: deleting
> E:\Users\Robert Scholte\maven-sites\plugins-archives and run 'mvn
> site-deploy -Preporting' for the third time.
>
> Now finally success.
>
> So I think we should add an optional delay to prevent the issue from my
> first run.
> I still don't understand what is the real issue with the second run.
>
> That's something about the process.
>
> The "Stage the Release"[2] chapter is missing a direct link to the page
> explaining how to publish the site.
>
> Robert
>
> [1]
> http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html
> #waitBeforeTagging [2]
> http://maven.apache.org/developers/release/maven-project-release-procedure.h
> tml#Stage_the_Release
>
>
> Op Sun, 22 Sep 2013 11:18:47 +0200 schreef Robert Scholte
>
> <rf...@apache.org>:
> > I will release the maven-deploy-plugin soon, so I can verify very well
> > if that part is complete.
> >
> > Robert
> >
> > Op Sun, 22 Sep 2013 01:49:25 +0200 schreef Hervé BOUTEMY
> >
> > <he...@free.fr>:
> >> I just published a documentation about CMS + svnpubsub for Maven, with
> >> schema
> >> for global overview of the differences and synchronization points
> >> between Maven
> >> site and components reference documentations [1]
> >>
> >> The documentation about Maven website is expected to be complete, but
> >> components reference documentation still needs improvements for people
> >> to
> >> better understand how the configuration is done. It can even be subject
> >> to
> >> discussion, since not every component uses the same process for the
> >> moment:
> >> one of my intents by doing this documentation is to be able to discuss
> >> with
> >> Maven devs to define our target convention. But for the moment, it is
> >> not
> >> possible since I know a lot of people are lost in different cases (and
> >> no,
> >> there is no CMS when we publish component reference documentation).
> >>
> >> Please review and tell if anything is not clear
> >>
> >> Regards,
> >>
> >> Hervé
> >>
> >> [1] http://maven.apache.org/developers/website/deploy-maven-website.html
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> >> For additional commands, e-mail: dev-help@maven.apache.org
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: CMS + svnpubsub explanations
Posted by Robert Scholte <rf...@apache.org>.
Hi,
And again my site publication wasn't straight forward, but I think I'm
hitting a Europe-delay issue.
After running 'mvn site-deploy -Preporting' for the first time, it ends
with a
[ERROR] Failed to check out from SCM: The svn command failed. svn:
E170000: URL
'https://svn.apache.org/repos/infra/websites/production/maven/content/plugins-archives/maven-deploy-plugin-LATEST'
doesn't exist
A couple of seconds later I get the following notification:
Log:
Automatic svn path creation:
https://svn.apache.org/repos/infra/websites/production/maven/content/ plugins-archives/maven-deploy-plugin-LATEST
This looks like the reason why waitBeforeTagging[1] was introduced for the
maven-release-plugin
Since I'm not sure if scm-publish:publish-scm will work, I decided to run
'mvn site-deploy -Preporting' again.
After a lot of "svn add"'s I get the following message:
[ERROR] Failed to add new files to SCM: The svn command failed. svn:
E155007: 'E:\Users\Robert
Scholte\maven-sites\plugins-archives\maven-deploy-plugin-LATEST\apidocs'
is not a working copy
By now I know that one solution is to start all over again: deleting
E:\Users\Robert Scholte\maven-sites\plugins-archives and run 'mvn
site-deploy -Preporting' for the third time.
Now finally success.
So I think we should add an optional delay to prevent the issue from my
first run.
I still don't understand what is the real issue with the second run.
That's something about the process.
The "Stage the Release"[2] chapter is missing a direct link to the page
explaining how to publish the site.
Robert
[1]
http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#waitBeforeTagging
[2]
http://maven.apache.org/developers/release/maven-project-release-procedure.html#Stage_the_Release
Op Sun, 22 Sep 2013 11:18:47 +0200 schreef Robert Scholte
<rf...@apache.org>:
> I will release the maven-deploy-plugin soon, so I can verify very well
> if that part is complete.
>
> Robert
>
> Op Sun, 22 Sep 2013 01:49:25 +0200 schreef Hervé BOUTEMY
> <he...@free.fr>:
>
>> I just published a documentation about CMS + svnpubsub for Maven, with
>> schema
>> for global overview of the differences and synchronization points
>> between Maven
>> site and components reference documentations [1]
>>
>> The documentation about Maven website is expected to be complete, but
>> components reference documentation still needs improvements for people
>> to
>> better understand how the configuration is done. It can even be subject
>> to
>> discussion, since not every component uses the same process for the
>> moment:
>> one of my intents by doing this documentation is to be able to discuss
>> with
>> Maven devs to define our target convention. But for the moment, it is
>> not
>> possible since I know a lot of people are lost in different cases (and
>> no,
>> there is no CMS when we publish component reference documentation).
>>
>> Please review and tell if anything is not clear
>>
>> Regards,
>>
>> Hervé
>>
>> [1] http://maven.apache.org/developers/website/deploy-maven-website.html
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
>> For additional commands, e-mail: dev-help@maven.apache.org
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: CMS + svnpubsub explanations
Posted by Robert Scholte <rf...@apache.org>.
I will release the maven-deploy-plugin soon, so I can verify very well if
that part is complete.
Robert
Op Sun, 22 Sep 2013 01:49:25 +0200 schreef Hervé BOUTEMY
<he...@free.fr>:
> I just published a documentation about CMS + svnpubsub for Maven, with
> schema
> for global overview of the differences and synchronization points
> between Maven
> site and components reference documentations [1]
>
> The documentation about Maven website is expected to be complete, but
> components reference documentation still needs improvements for people to
> better understand how the configuration is done. It can even be subject
> to
> discussion, since not every component uses the same process for the
> moment:
> one of my intents by doing this documentation is to be able to discuss
> with
> Maven devs to define our target convention. But for the moment, it is not
> possible since I know a lot of people are lost in different cases (and
> no,
> there is no CMS when we publish component reference documentation).
>
> Please review and tell if anything is not clear
>
> Regards,
>
> Hervé
>
> [1] http://maven.apache.org/developers/website/deploy-maven-website.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org