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
