iain duncan wrote: > 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. > Why don't we start out with SO-only documents. Then we can identity the portions that vary between DB platforms and develop "plug-in" replacements for the SO bits.
We could use a web framework (like TurboGears!) to integrate this so one could just select one's platform either in the URLs or as a session variable value. regards Steve -- Steve Holden +44 150 684 7255 +1 800 494 3119 Holden Web LLC/Ltd http://www.holdenweb.com Skype: holdenweb http://holdenweb.blogspot.com Recent Ramblings http://del.icio.us/steve.holden --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
