Re: [xwiki-devs] [Contrib] xwiki-application-mailarchive

I eventually was able to use push to git from maven with release plugin (had to reinstall git with more preservative options). But previous issue is still there: when checking-out my tag from local clone in target/checkout, pom.xml files are not there so there's nothing to build for maven ... 2012/9/1 Jeremie BOUSQUET &lt;jeremie.bousquet(a)gmail.com&gt;om>: > Progressing but still failing ... > > ... it's like a nightmare. > > I gave up pushing to github from maven, I think there's something > wrong with windows/mysysgit/cygwin somehow. > > Now trying to release tag "xwiki-contrib-mailarchive-0.1": > - it's pushed on github > - if I download the related zip (in "tag" tab on github), it's complete > - if I "release:perform" from maven, target/checkout folder contains > everything except pom.xml files ... of course release fails > > How can my pom.xml files be deleted when running "git checkout > xwiki-contrib-mailarchive-0.1", while I can see them in my local > history and on github ??? > > > 2012/8/31 Jeremie BOUSQUET &lt;jeremie.bousquet(a)gmail.com&gt;om>: >> I tried both, but not tried exhaustively possible combinations >> (ssh/https, maven/git conf, and my network proxy that comes in the way >> ...) >> BTW I'm not sure about how credentials for github should be fed to >> maven depending on SSH/HTTPS url connection used. >> Authentication with keys works from git command-line to push to >> github, but I think I miss some configuration maven-side. >> Actually from maven "git push" time-outs, or freezes forever, >> depending on protocol used. >> >> >> 2012/8/31 Thomas Mortagne &lt;thomas.mortagne(a)xwiki.com&gt;om>: >>> On Fri, Aug 31, 2012 at 9:17 AM, Jeremie BOUSQUET >>> &lt;jeremie.bousquet(a)gmail.com&gt; wrote: >>>> Hi Community, >>>> >>>> I'm trying to release my contrib project to nexus staging but having >>>> difficulties. >>>> >>>> Couldn't manage to "git push" correctly from maven to github (though >>>> "git push" command-line works), so I use "-DpushChanges=false" during >>>> release:prepare and release:perform, and do a "git push" manually >>>> after release:prepare. >>> >>> You sure you <scm> is right ? I see you indicated the https in >>> <developerConnection>, you should probably use the ssh one instead. >>> >>>> >>>> Now getting that during release:perform (***** were added, it's a >>>> correct path behind) : >>>> >>>> [INFO] --- maven-enforcer-plugin:1.0.1:enforce >>>> (enforce-javadoc-exists) @ xwiki-contrib-mailarchive --- >>>> [WARNING] Rule 0: >>>> org.apache.maven.plugins.enforcer.EvaluateBeanshell failed with >>>> message: >>>> Couldn't evaluate condition: ("pom" != "jar") || ("pom" == "jar" >>>> && new java.io.File("C:\*****\target\checkout\target/xwiki-contrib-mailarchive-0.1-javadoc.jar").exists()) >>>> >>>> Of course javadoc does not exist at this level, as I'm trying to >>>> release from root aggregator. What I don't understand is why the >>>> enforcer rule fails ? Aggregator is of type "pom" as expected. >>>> >>>> My command-line was: >>>> >>>> mvn release:perform -DpushChanges=false >>>> -DconnectionUrl=scm:git:https://github.com/xwiki-contrib/xwiki-application-mailarchive.git >>>> -Dtag=xwiki-contrib-mailarchive-0.1 >>>> >>>> >>>> Thanks, >>>> Jeremie >>>> >>>> >>>> 2012/8/17 Jeremie BOUSQUET &lt;jeremie.bousquet(a)gmail.com&gt;om>: >>>>> Hi Vincent, >>>>> >>>>> I saw that, no problem I'll update the groupId before doing the release :) >>>>> >>>>> Br, >>>>> Jeremie >>>>> >>>>> 2012/8/16 Vincent Massol &lt;vincent(a)massol.net&gt;et>: >>>>>> Hi Jeremie, >>>>>> >>>>>> In case you haven't followed we've updated the contrib rule for the maven group id, see >>>>>> http://contrib.xwiki.org/xwiki/bin/view/Main/WebHome >>>>>> >>>>>> It would be great if you could update your groupid before you do the first release :) >>>>>> >>>>>> Thanks >>>>>> -Vincent >>>>>> >>>>>> On Aug 16, 2012, at 9:50 AM, Jeremie BOUSQUET wrote: >>>>>> >>>>>>> Thanks Vincent & Sergiu, >>>>>>> >>>>>>> So, is it ok if I put docs to >>>>>>> http://extensions.xwiki.org/xwiki/bin/view/MailArchive/Documentation >>>>>>> (and others in same space) ? >>>>>>> >>>>>>> By now I've almost finished writing first versions of: >>>>>>> * MailArchive.Documentation (home page) >>>>>>> * MailArchive.UserGuide >>>>>>> * MailArchive.AdminGuide >>>>>>> * MailArchive.OperationsGuide >>>>>>> * MailArchive.TroubleShooting >>>>>>> >>>>>>> I should be able to release 0.1 soon ... >>>>>>> >>>>>>> Br, >>>>>>> Jeremie >>>>>>> >>>>>>> 2012/8/13 Thomas Mortagne &lt;thomas.mortagne(a)xwiki.com&gt;om>: >>>>>>>> On Mon, Aug 13, 2012 at 3:23 PM, Vincent Massol &lt;vincent(a)massol.net&gt; wrote: >>>>>>>>> >>>>>>>>> On Aug 13, 2012, at 3:17 PM, Vincent Massol wrote: >>>>>>>>> >>>>>>>>>> Hi Jeremie and all, >>>>>>>>>> >>>>>>>>>> Back from holidays too :) Cool to see progress on this! >>>>>>>>>> >>>>>>>>>> Ok I've parsed this thread and here's my take: >>>>>>>>>> >>>>>>>>>> * JIRA: I'll create a dedicated JIRA project since the project seems large enough to warrant it >>>>>>>>> >>>>>>>>> ok, Thomas is doing it ATM, should be ready real soon :) >>>>>>>> >>>>>>>> Done, http://jira.xwiki.org/browse/XMAILARCH. You should have the >>>>>>>> rights to do pretty much anything in this project. >>>>>>>> >>>>>>>>> >>>>>>>>>> * Documentation: our rule is currently to have pages on extensions.xwiki.org and if the project becomes too large to create a dedicated wiki for it, as we've done for rendering.xwiki.org, commons.xwiki.org, enterprise, etc for example (see http://contrib.xwiki.org/xwiki/bin/view/Main/WebHome). IMO it's ok ATM to have several pages on e.x.o for the MailArchive application and we can decide later on to move it to its own wiki (after we have a 1.0 released IMO). >>>>>>>>>> * Nexus: I'll create an account for you. >>>>>>>>> >>>>>>>>> I see you already have a user, cool. >>>>>>>>> >>>>>>>>> Thanks >>>>>>>>> -Vincent >>>>>>>>> >>>>>>>>>> Is that ok? >>>>>>>>>> >>>>>>>>>> Thanks >>>>>>>>>> -Vincent >>>>>>>>>> >>>>>>>>>> On Aug 10, 2012, at 9:51 AM, Jeremie BOUSQUET wrote: >>>>>>>>>> >>>>>>>>>>>> So I'd say that: >>>>>>>>>>>> >>>>>>>>>>>> - There should be some documentation on the extension page, at least a >>>>>>>>>>>> description of the project, some usage scenarios, some screenshots, and a >>>>>>>>>>>> list of the features >>>>>>>>>>>> - I agree that the full documentation should be included in the application >>>>>>>>>>>> itself >>>>>>>>>>>> - The same full documentation should also be available online, and the >>>>>>>>>>>> contrib wiki seems to be the right place (in a dedicated space) >>>>>>>>>>> >>>>>>>>>>> I think it's the best solution. >>>>>>>>>>> Since the space I currently use for the main pages of my app is >>>>>>>>>>> "MailArchive", I would propose to use the same for the documentation >>>>>>>>>>> space and put pages under: >>>>>>>>>>> http://contrib.xwiki.org/xwiki/bin/view/MailArchive/ >>>>>>>>>>> >>>>>>>>>>> That way publishing the doc online to contrib wiki would be >>>>>>>>>>> straightforward with selective import. >>>>>>>>>>> >>>>>>>>>>> Br, >>>>>>>>>>> Jeremie >>>>>>>>>>> >>>>>>>>>>> 2012/8/9 Sergiu Dumitriu &lt;sergiu(a)xwiki.com&gt;om>: >>>>>>>>>>>> On 08/09/2012 10:38 AM, Jerome Velociter wrote: >>>>>>>>>>>>> >>>>>>>>>>>>> On 08/09/2012 04:34 PM, Jeremie BOUSQUET wrote: >>>>>>>>>>>>>> >>>>>>>>>>>>>> Humm ... Just thinking I might put that directly inside my app xar ... >>>>>>>>>>>>>> WDYT ? >>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>> I'm a big fan of self-documenting applications. It has the great >>>>>>>>>>>>> advantage of always offering documentation matching the version in use. >>>>>>>>>>>>> >>>>>>>>>>>>> But you might also want to offer the latest released version >>>>>>>>>>>>> documentation online. I think there are some extensions that have >>>>>>>>>>>>> documentation that spans several pages, but honestly I don't know if >>>>>>>>>>>>> this is something we want/we agreed upon. I'll leave it to others to >>>>>>>>>>>>> bring more information on this subject. There is the contrib wiki also >>>>>>>>>>>>> which could be a candidate. >>>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> I've seen extensions with a lot of documentation on their extension page, >>>>>>>>>>>> and I've seen things documented in several places. Personally, I don't like >>>>>>>>>>>> huge extension pages. >>>>>>>>>>>> >>>>>>>>>>>> So I'd say that: >>>>>>>>>>>> >>>>>>>>>>>> - There should be some documentation on the extension page, at least a >>>>>>>>>>>> description of the project, some usage scenarios, some screenshots, and a >>>>>>>>>>>> list of the features >>>>>>>>>>>> - I agree that the full documentation should be included in the application >>>>>>>>>>>> itself >>>>>>>>>>>> - The same full documentation should also be available online, and the >>>>>>>>>>>> contrib wiki seems to be the right place (in a dedicated space) >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>>> >>>>>>>>>>>>>> 2012/8/9 Jeremie BOUSQUET &lt;jeremie.bousquet(a)gmail.com&gt;om>: >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> Thanks Jerome, >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> Another thing about this project: I'd like to prepare things, and >>>>>>>>>>>>>>> particularly the user guide part, so it's available when I'll publish >>>>>>>>>>>>>>> the extension. >>>>>>>>>>>>>>> For this particular use-case though, I'd like to extend the user/admin >>>>>>>>>>>>>>> guide part on more than one page, as it may be quite large. >>>>>>>>>>>>>>> Where should I put these pages ? >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> Thanks, >>>>>>>>>>>>>>> Jeremie >>>>>>>>>> >>>>>>>>> >>>>>>>>> _______________________________________________ >>>>>>>>> devs mailing list >>>>>>>>> devs(a)xwiki.org >>>>>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> Thomas Mortagne >>>>>>>> _______________________________________________ >>>>>>>> devs mailing list >>>>>>>> devs(a)xwiki.org >>>>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>>>>> _______________________________________________ >>>>>>> devs mailing list >>>>>>> devs(a)xwiki.org >>>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>>>> >>>>>> _______________________________________________ >>>>>> devs mailing list >>>>>> devs(a)xwiki.org >>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>> _______________________________________________ >>>> devs mailing list >>>> devs(a)xwiki.org >>>> http://lists.xwiki.org/mailman/listinfo/devs >>> >>> >>> >>> -- >>> Thomas Mortagne >>> _______________________________________________ >>> devs mailing list >>> devs(a)xwiki.org >>> http://lists.xwiki.org/mailman/listinfo/devs