Hi Vincent, That's really nice, and I wanted to add it anyway, but now it's traced :) : http://jira.xwiki.org/browse/XMAILARCH-12
BTW, I've started feeding the issues I plan to correct in 0.2 in JIRA. Br, Jeremie 2012/9/18 Vincent Massol <[email protected]>: > Hi Jeremie, > > For the next version of the MailArchive app you may want to add a Application > Panel UIExtension object so that the mailarchive application appears in the > new Application panel automagically when it's installed. It would be very > nice. > > See > http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/ReleaseNotesXWikiEnterprise42M3#HNewApplicationsPanel > > Note that it requires XWiki 4.2M3+ but if the XClass isn't there it's not > going to fail on older XWiki versions (it just won't do anything). > > Thanks > -Vincent > > On Sep 14, 2012, at 4:16 PM, Jeremie BOUSQUET <[email protected]> > wrote: > >> Hum, thanks ... >> As it's not a so big issue I think what I'll prefer to do, is fastly >> deliver a new 0.2 version with fixed page, and leave the 0.1 as it is, >> or ask for its deletion later. >> >> >> 2012/9/14 Thomas Mortagne <[email protected]>: >>> On Fri, Sep 14, 2012 at 3:04 PM, Jeremie BOUSQUET >>> <[email protected]> wrote: >>>> I was almost sure I would make a mistake, and I did... >>>> In the documentation embedded in the .xar, the user guide is not >>>> correct, because it has screenshots coming from the app as used in my >>>> organization ... >>>> Not that there are things so confidential, but still not something I'm >>>> fond of. >>>> >>>> Do you think it would be possible to either: >>>> - replace delivered 0.1 with a new 0.1 version with fixed >>>> documentation ? (hideously ugly, but as it impacts only documentation >>>> ...) >>>> - deliver a new 0.2 and remove 0.1 from nexus ? >>> >>> It's not yet Maven central rules ( ;) ) so we can remove things if you >>> absolutely need to. Note that it also mean delete the current 0.1 tag >>> from git. As you prefer, it's recent enough to be deleted even if it's >>> a pain on your side to do. >>> >>>> >>>> Anyway for sure I will not put the same on e.x.o ... >>>> >>>> Br, >>>> Jeremie >>>> >>>> >>>> >>>> 2012/9/14 Jeremie BOUSQUET <[email protected]>: >>>>> 2012/9/14 Thomas Mortagne <[email protected]>: >>>>>> On Fri, Sep 14, 2012 at 12:57 PM, Jeremie BOUSQUET >>>>>> Note that the id are wrong (one of the reason to use the import UI >>>>>> instead of creating from scratch ;)). You can change it in edit >>>>>> object, it's important have the same id that the one on maven >>>>>> repository which mean >>>>>> org.xwiki.contrib.mailarchive:xwiki-contrib-mailarchive-ui for the ui >>>>>> for example otherwise Extension Manager will see two different >>>>>> extensions in extensions.xwiki.org and maven repositories while it's >>>>>> actually exactly the same thing. >>>>> >>>>> This is fixed, thanks ! >>>>> That "import" button, I noticed it, and still can't understand why I >>>>> didn't click on it ! :D >>>>> >>>>>> >>>>>>> >>>>>>> 2012/9/14 Thomas Mortagne <[email protected]>: >>>>>>>> On Fri, Sep 14, 2012 at 9:13 AM, Jeremie BOUSQUET >>>>>>>> <[email protected]> wrote: >>>>>>>>> I guess I have to create an extension page for each artifact ? (mail >>>>>>>>> extension, mailarchive api extension, mail archive ui extension) >>>>>>>>> Didn't had time to test within extension repository manager locally, >>>>>>>>> so I hope it'll work ! :) >>>>>>>> >>>>>>>> Actually since it's released on maven repository you can import it and >>>>>>>> then complete the description. >>>>>>>> >>>>>>>>> >>>>>>>>> 2012/9/13 Vincent Massol <[email protected]>: >>>>>>>>>> I guess the next step is to create the extension page on e.x.o. >>>>>>>>>> >>>>>>>>>> That'll be awesome and I'll start testing it when it's there! :) >>>>>>>>>> >>>>>>>>>> Thanks >>>>>>>>>> -Vincent >>>>>>>>>> >>>>>>>>>> On Sep 13, 2012, at 1:39 PM, Jeremie BOUSQUET >>>>>>>>>> <[email protected]> wrote: >>>>>>>>>> >>>>>>>>>>> Thanks ! >>>>>>>>>>> No problem ... >>>>>>>>>>> >>>>>>>>>>> 2012/9/13 Vincent Massol <[email protected]>: >>>>>>>>>>>> >>>>>>>>>>>> On Sep 13, 2012, at 10:13 AM, Jeremie BOUSQUET >>>>>>>>>>>> <[email protected]> wrote: >>>>>>>>>>>> >>>>>>>>>>>>>> 2012/9/2 Jeremie BOUSQUET <[email protected]>: >>>>>>>>>>>>>>> I could successfully deploy mail archive artifacts to nexus >>>>>>>>>>>>>>> staging ! >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> Would someone kindly promote it ? :) >>>>>>>>>>>>> >>>>>>>>>>>>> Hi, just to recall that to you ... :) >>>>>>>>>>>>> (I know, seems a bit of a rush on 4.2 cycle and there is no >>>>>>>>>>>>> urgency on >>>>>>>>>>>>> my side, just want to avoid moving too deep in the mailing-list) >>>>>>>>>>>> >>>>>>>>>>>> Done! Sorry for the lag… >>>>>>>>>>>> >>>>>>>>>>>> -Vincent >>>>>>>>>>>>> >>>>>>>>>>>>> 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) >>>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>> Thanks, >>>>>>>>>>>>> Jeremie >>>>>>>>>>>>> >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> 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 >>>>>>>>> _______________________________________________ >>>>>>>>> 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 >>>>>> >>>>>> >>>>>> >>>>>> -- >>>>>> 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 >>> >>> >>> >>> -- >>> 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
