BTW, any comments on question below ? 2012/9/3 Jeremie BOUSQUET <[email protected]>:
Hi again
Another thing, I'd like to selectively import the mailarchive ui xar, to create the documentation pages on xwiki.org (Extensions.Mail+Archive+Documentation and so on...), but of course admin rights are needed for that.
Any recommendations ? I'd like to avoid recreating the pages by copy / paste (most of all because of the numerous screenshots attached). I could copy/paste into wysiwyg editor, but I'd prefer something more straightforward to get a copy of the documentation pages from the application xar.
Br, Jeremie
2012/9/2 Jeremie BOUSQUET <[email protected]>:
(groupId : org.xwiki.contrib.mailarchive, version : 0.1, artifacts xwiki-contrib-mail, xwiki-contrib-mailarchive-api, xwiki-contrib-mailarchive-ui)
2012/9/2 Jeremie BOUSQUET <[email protected]>:
So after selectively deactivating execution of "enforce-javadoc-exists" for my root pom, and configuration of gpg, I could successfully deploy mail archive artifacts to nexus staging !
Would someone kindly promote it ? :)
Thanks, Jeremie
2012/9/1 Jeremie BOUSQUET <[email protected]>:
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 <[email protected]>:
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 <[email protected]>:
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 <[email protected]>: > 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 <[email protected]>: >> On Fri, Aug 31, 2012 at 9:17 AM, Jeremie BOUSQUET >> <[email protected]> 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 <[email protected]>: >>>> Hi Vincent, >>>> >>>> I saw that, no problem I'll update the groupId before doing the release :) >>>> >>>> Br, >>>> Jeremie >>>> >>>> 2012/8/16 Vincent Massol <[email protected]>: >>>>> 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 <[email protected]>: >>>>>>> On Mon, Aug 13, 2012 at 3:23 PM, Vincent Massol <[email protected]> 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 <[email protected]>: >>>>>>>>>>> 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 <[email protected]>: >>>>>>>>>>>>>> >>>>>>>>>>>>>> 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 >>>>>>>> [email protected] >>>>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>>>>> >>>>>>> >>>>>>> >>>>>>> -- >>>>>>> Thomas Mortagne >>>>>>> _______________________________________________ >>>>>>> devs mailing list >>>>>>> [email protected] >>>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>>>> _______________________________________________ >>>>>> devs mailing list >>>>>> [email protected] >>>>>> http://lists.xwiki.org/mailman/listinfo/devs >>>>> >>>>> _______________________________________________ >>>>> devs mailing list >>>>> [email protected] >>>>> http://lists.xwiki.org/mailman/listinfo/devs >>> _______________________________________________ >>> devs mailing list >>> [email protected] >>> http://lists.xwiki.org/mailman/listinfo/devs >> >> >> >> -- >> Thomas Mortagne >> _______________________________________________ >> devs mailing list >> [email protected] >> http://lists.xwiki.org/mailman/listinfo/devs