[xwiki-devs] MetadataLuceneTutorial on xwiki.org - Where should it go?

[Vincent Massol]

Hi,

On Mar 4, 2008, at 11:15 PM, jvivien.m2 jvivien.m2 wrote:

> hello,
>
> I am back..
> - is the tutorial approved ? is it useful to the community ?

I think you should move it to the draft area for now while we can  
correct it. Can you do that?

I'll add a comment on the tutorial page mentioning some draft work and  
pointing it there so that people can still find it easily.

> - could it relate to possible improvements to the core/modules ?  
> then please give me directions and I will work on that.

I'm pretty sure it could. Actually seen the length of your tutorial  
I'm 100% percent sure the code needs to be improved to better support  
your use case.
See http://blogs.codehaus.org/people/vmassol/archives/001314_documentationdriven_development.html

I'll need to read it better to good your more details.

Thanks
-Vincent

> On 2/26/08, jvivien.m2 jvivien.m2 <jean.vivien.maurice at gmail.com>  
> wrote:
> well the DWR tutorial was never completed, and its the next project.
> In fact what I am doing with this tutorial (and hopefully with  
> another one talking about DWR and tree view) is the result of my end- 
> of-studies internship. The prototype I have done at my internship  
> company was rejected by my company's management. But everybody was  
> impressed by the work i had done, which was basically porting one  
> system to a wiki platform, so using xwiki as a basis and extend it a  
> bit. Since my prototype will not be used for further dev by the  
> company, I am trying to give something back from my internship - 4  
> months of work *have* to produce something useful, and I hope it  
> will be my xwiki tutorials.
>
> I will correct everything in the tut' when i am back from a family  
> trip (after the 4th of March, thus). In the meantime, please put my  
> tutorial into the draft section and let the dev community decide  
> what to do with it (or do whatever you want with it). Just tell me  
> what has happened... We can add the functionnality to the core  
> (though I will need help from  on how to design the modifications  
> that have to be made). It will be a pleasure to work on this for me,  
> and to give something back to XWiki. It will not be done overnight,  
> though. If I get a job from the 1st of April, then I may not have  
> much time in April. Of course during March i will definitely have  
> time to devote to XWiki :-). i am up to it, if you want...
>
> On 2/26/08, Vincent Massol <vincent at massol.net> wrote:
> BTW Jean-Vivien you also have another tutorial you had started on http://dev.xwiki.org/xwiki/bin/view/Drafts/PluginDWR
> which could also be moved at the same location we decide to move
> this new tutorial.
>
> -Vincent
>
> On Feb 26, 2008, at 9:41 PM, Vincent Massol wrote:
>
> > I forgot to clearly say I was very impressed by the done work by
> > Jean-Vivien.
> >
> > Seems he's really researched the xwiki development capabilities!
> >
> > Jean-Vivien, since you seem to have a really good grasp of XWiki I
> > hope you'll consider contributing improvements to it and maybe even
> > join us as a  committer one day :)
> >
> > Thanks
> > -Vincent
> >
> > On Feb 26, 2008, at 9:36 PM, Vincent Massol wrote:
> >
> >> Hi everyone and Jean-Vivien,
> >>
> >> Jean-Vivien has done a lot of good work adding a tutorial on
> >> xwiki.org.
> >> See http://platform.xwiki.org/xwiki/bin/view/DevGuide/MetadataLuceneTutorial
> >>
> >> However I'm wondering where we should put it. Here's my current
> >> thinking:
> >>
> >> * This tutorial reflects Jean-Vivien's point of view only since  
> it's
> >> never been discussed AFAIK and there's no general agreement about  
> its
> >> content with the rest of the xwiki developers. As such I don't  
> think
> >> it can be located in at the same level as the other tutorials which
> >> have been "endorsed" by the xwiki community.
> >>
> >> I see 2 solutions:
> >>
> >> 1) We move it to the draft area and Jean-Vivien submits it for  
> review
> >> to the xwiki dev community. If the community agrees this is the  
> right
> >> way to implement it we put it with the other tutorials/
> >>
> >> 2) We move it to a contribution area that clearly marks the  
> document
> >> as a contributor's view and not as endorsed by the xwiki  
> development
> >> community. We don't have such a place today so we'll need to create
> >> it. We could create it as a subpage of the Tutorial page in the
> >> DevGuide or we could move it to the code zone to the code snippet
> >> space since what Jean-Vivien has done is basically provide code
> >> snippets to extend xwiki. It's a little bit more than a code  
> snippet
> >> since it's also a tutorial so I'm not sure the code zone is the  
> best
> >> place for it.
> >>
> >> WDYT?
> >>
> >>
> >> Jean-Vivien, some quick comments/questions on the content:
> >>
> >> * Jens Karmer was the original author of the Lucene plugin. Since
> >> then
> >> it's been worked on by numerous people.
> >> * You shouldn't put ":" in titles
> >> * The tutorial is missing a section at the beginning to explain  
> what
> >> the tutorial is about
> >> * I haven't read the tutorial yet but if what you've done is useful
> >> why not consider improving xwiki's core to support what you need?  
> For
> >> example it seems to me you're asking for a way to add custom  
> metadata
> >> to the lucene plugin. This could easily be added as part of the
> >> lucene
> >> plugin API.
> >>
> >> Thanks
> >> -Vincent
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.xwiki.org/pipermail/devs/attachments/20080305/8b3a3f5f/attachment-0001.htm