On Fri, 2007-26-01 at 23:39 -0400, Jorge Vargas wrote: > On 1/24/07, Mark Ramm <[EMAIL PROTECTED]> wrote: > > > > > A FAQ would be fine by me, as a number of questions are asked on a > > > fairly regular basis: Compare TG/Django/Pylons, Use SA, Books, > > > alternate templates, project structuring, etc. I'm not including > > > widgets because the problem there is a larger lack of docs. > > > > I think a FAQ is a good way to go for basic questions. For now we > > should probably keep it to questions, with a line or two of answer, > > and links to other places where there's more information. (Other > > Docs, threads on the mailing list, etc.) > > > I'm not sure about FAQ most are never read :) > I do agree that they should be short with links, most documentation is > build around this concept, take for example the Database* pages, back > on trac when I started them they where all build with the "FAQ" in > mind, and they all follow the same structure, how do I install the db, > which is the format of the query string what are the common > problems,etc.
I dunno, they're one of the first things I read when checking out a new project. Iain --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
