On Mon, 2007-05-02 at 01:03 -0400, Jorge Vargas wrote: > On 2/4/07, tamara6 <[EMAIL PROTECTED]> wrote: > > > > What else needs to be covered or covered better? > > I'm a new user, having come over from Django because I didn't > like how > restrictive it felt (and the ORM really confused me). I've > been using > SO because it looks like not everything in TG works with SA > yet (and > if that isn't true then the docs should clear that up). > > actually this is not true, the only thing that is not supported are > the "third party apps" like CatWalk and ModelDesigner, which are > developer tools everything else is fine. I guess the real debate is > how to use SA, some people like plain SA, others ActiveMapper (is the > the name of Jonathan's SO-like layer?), order like a new one call > TurboEntity, and as Karl pointed out there is a 3th one which is > supposed to be the killer one :) > > > The biggest problem I've had with TG is figuring out how to > use SO. > The book gives basic info, but both the TG website and the SO > website > are very weak in this regard. What I'd find most useful is a > page > like this one [1] for SO. > > taking a quick look at the URL I don't see anything that is not answer > in > http://www.sqlobject.org/SQLObject.html > http://www.sqlobject.org/SQLBuilder.html > http://www.sqlobject.org/module-index.html > > although I have to admit that django's site has more words but not > necessary more content.
I disagree. To a new user the django api docs are a lot more readable and accessible. Denying this is not going to help anything, telling users who are confused that they are wrong about doc issues is only going to send them away. I learnt both SO and Django from the online docs and had not used an ORM before. It was definitely smoother sailing with the Django docs. And I say this as a converted to TG user. I think experienced coders need to remember that the *real* authority on whether docs are good is *inexperienced new* users. We're not talking about man page here. 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 -~----------~----~----~----~------~----~------~--~---
