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