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?


_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to