Re: [xwiki-devs] [Reminder] How to best answer questions on the list

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#HStrategiesforan… 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(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs