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#HStrategiesforansweringontheXWikilists

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
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to