On Sat, 27 Jan 2007 at 11:16, Christopher Arndt wrote: > Jorge Vargas schrieb: >> I'm not sure about FAQ most are never read :) > > That may be, but I see a FAQ mostly as a place where pointers to documentation > are collected, so that if somebody ask some question on the ml that is already > answered in the FAQ, you can just reply with:
In my personal experience the best FAQs are ones that really are based on FAQs. Often they contain just the tidbit of information you need, which may well be in the docs but you didn't notice it when you were reading them. And yes, that means the docs could be improved, but sometimes there's time/resources to write a FAQ entry but not time/resources to do the (sometimes extensive) doc rewrite that would fix the doc problem. Also, I agree with the poster who said that he often reads the FAQ for project first. I often find the FAQ gives a quickly digestible overview (sometimes just by reading the questions ;), and it often answers key questions about suitability that prevents me from wasting my time learning a project that won't actually be useful for me. --David --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/turbogears?hl=en -~----------~----~----~----~------~----~------~--~---
