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

Reply via email to