On Mon, 2006-13-11 at 14:42 -0500, Karl Guertin wrote: > On 11/13/06, Mikkel Høgh <[EMAIL PROTECTED]> wrote: > > I also think we should consider porting all our docs to SQLAlchemy as > > that seems to be The Future(tm) of TurboGears :) > > The official ORM for 1.0 is SQLObject. All docs in 1.0/* will use > SQLObject exclusively unless they're specifically about SQLAlchemy. I > personally prefer SA but the call has been made and I want a > consistent story in the docs without a whole bunch of "if you use..." > digressions. I have not been enforcing this (actually > IdentityManagment is the only one that covers both ORMs) but I > probably will start moving SA references to footnotes as we get the > docs finalized for 1.0. > > > That is not very important though, but I think we should make it a > > policy for the 1.1 docs :) > > When SA becomes the official ORM, all examples will switch to SA > examples, whatever form SA support looks like at that point (straight > SA, ActiveMapper, TurboEntity, whatever Jonathan LaCour and friends > are currently working on, etc). Until then, SQLObject will remain as > the example ORM in all the docs.
Is there any reason not to have dual versions? I know we want "one good way" but I have to say part of my attraction to gears is that is more unixy, we have choice of modules. My dream world would be a plugable switch between the two in which the mapper enable one to change only the model file. At any rate, as the book covers SO, I don't think it's a good idea to "switch" the docs when 1.1 comes out or we will have a *lot* of annoyed new users who bought the book. I think it's very important to be able to follow good docs on both approaches. 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 -~----------~----~----~----~------~----~------~--~---
