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

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