Hi devs,
I've created a new FAQ application.
It's currently available from
http://www.xwiki.org/xwiki/bin/view/FAQ/WebHomeNew
(it's linked from the old one:
http://www.xwiki.org/xwiki/bin/view/FAQ/WebHome)
The reason I rewrote it is because I think FAQs are important and that we're not using
it enough
Here's how I think it could work out:
* If a user has a question he/she should verify if it's already in the FAQ. If not
then he/she should post a message for the XWiki Mailing List/Forum.
* The strategy is then for people who know the answer to create a new FAQ entry about the
question and reply in the mail with the link to the new FAQ Entry
In this manner we will quickly enrich this FAQ database.
Of course the FAQ answers should be as short as possible and point to existing docs (if
those docs don't exist they should be updated/created).
Basically I see FAQ as entry points to our documentation, from the point of view of
someone asking questions of the type "how do I….".
Thus there can be several FAQ entries all having the same link to the documentation.
WDYT?
Thanks
-Vincent
PS: As you can see I have only 4 entries right now since we need to migrate exisitng FAQ
entries:
- use a good page name
- rewrite them in XWiki Syntax 2.0
- verify their accuracy
- update docs where needed
Maybe we should have a FAQ day to work on that?