Hi Vincent, Please, allow me to forward this message to the people working with XWiki here. The problem you are describing has a fractal component: it is reproduced again and again at any structure level wherever you find a working group. And it not only apply to XWiki issues, of course! I will try to follow this method as much as possible and encourage others not to stick to our small group circle and try to contribute with their doubts and finding to the growth of XWiki community. Thanks and cheers, Ricardo Vincent Massol wrote:

In order to be as efficient as possible in answering questions and so that the answer benefit others the most we had defined a strategy. It's written on http://dev.xwiki.org/xwiki/bin/view/Community/Contributing#HStrategiesforans...

Here's the relevant excerpt:

" 1.1 Strategies for answering on the XWiki lists

Here's a good strategy that improves the XWiki documentation on xwiki.org: 1. someone (A) asks a question on a xwiki list 1. someone (B) knows the answer 1. B verifies that the answer can be found on xwiki.org and if so gives a link to it in the reply to A 1. If the answer is not found on xwiki.org, then B adds it (*) and then gives a link to it in the reply to A

In this manner we all enrich the xwiki documentation and it'll only take marginally longer to answer questions. The next time someone asks the question again we can simply point him/her to the location on xwiki.org

What happens otherwise is that usually people answer in the email, often giving very long and elaborate answers with lots of knowledge/ wisdom in it. Then another person comes in, asks the same question and we answer again, etc. The result is: * the xwiki.org documentation is not better * overall as a team we are less efficient

(*) One difficult in putting the answer on xwiki.org is to find the right location where to put it. So here are a few tips: * For code snippets, add it to the [Code Zone>code:Main.WebHome] * For questions on how to use XWiki, please add it to the [Features guide>platform:Features.WebHome] * For development questions, add it to the [Developer's guide>platform:DevGuide.WebHome] * For configuration questions and administration questions, add it to the [Administration guide>platform:AdminGuide.WebHome] * For other questions, add them to the [FAQ>xwiki:FAQ.WebHome] "

I've seen a lot of emails recently where we're not doing this (me included) and thus I thought it would be to remind us all about strategy. Also xwiki.org hasn't been improved a lot for a while so it's good to make an effort to do so. Could be a good thing to do especially during the bug fixing week.

WDYT?

Thanks -Vincent

_______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs

-- Ricardo Rodríguez Your EPEC Network ICT Team