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