Strategy for FAQ handling

Vincent Massol vincent at massol.net
Sun Aug 26 19:34:17 CEST 2007


I also propose to drop support for XWiki versions prior to 1.0 and  
remove issues that are no longer relevant for 1.0 and beyond.

-Vincent

On Aug 26, 2007, at 7:22 PM, Vincent Massol wrote:

> Hi,
>
> Just wanted to explain my current strategy for FAQs on xwiki.org.  
> Whenever I review FAQ pages I do the following:
>
> 1) Check if there's a page in the wiki that discusses the question  
> mentioned in the FAQ page
> 2) If there is, remove the FAQ content and instead link to that  
> page. If there were more information in the FAQ entry, move that  
> information to the page proper
> 3) if there isn't, then create a new page, in the user guide, dev  
> guide or admin guide and then go to step 2.
>
> IMO this is the best strategy for the best of both world:
> 1) Have a comprehensive documentation
> 2) Prevent duplication
> 3) Still keep the FAQ entries so that people can find them easily  
> using google or the wiki search and then get directed to the  
> relevant documentation page.
>
> All help is welcome!
>
> Thanks
> -Vincent





More information about the users mailing list