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

2012/9/2 Jeremie BOUSQUET <jeremie.bousquet(a)gmail.com>om>: > I could successfully deploy mail archive artifacts to nexus staging ! > > Would someone kindly promote it ? :)

(groupId : org.xwiki.contrib.mailarchive, version : 0.1, artifacts xwiki-contrib-mail, xwiki-contrib-mailarchive-api, xwiki-contrib-mailarchive-ui)

> > Thanks, > Jeremie > > 2012/9/1 Jeremie BOUSQUET &lt;jeremie.bousquet(a)gmail.com&gt;om>: >> Wow, eventually, it worked ... Had to switch to using >> maven-release-plugin last version (2.3.2) instead of the one from >> xwiki. >> >> Now I'm ... back to the initial issue with the enforcer : >> >> [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:\PRIVATE\Dropbox\MAILARCHIVE\target\checkout\target/xwiki-contrib-mailarchive-0.1-javado >> c.jar").exists()) >> [INFO] ------------------------------------------------------------------------ >> >> >> Grrrr ! >> >> >> 2012/9/1 Jeremie BOUSQUET &lt;jeremie.bousquet(a)gmail.com&gt;om>: >>> 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