On 10/19/07, Ben Sizer <[EMAIL PROTECTED]> wrote: > > On Oct 17, 3:00 pm, "Gaetan de Menten" <[EMAIL PROTECTED]> wrote: > > On 10/17/07, Ben Sizer <[EMAIL PROTECTED]> wrote: > > > > > However, I would argue that the Elixir docs are not as > > > easy to use as the SO docs, so moving to SA and recommending Elixir on > > > top is not really beneficial from an ease-of-use point of view. I > > > don't know if others would agree however. > > > > Yes, I agree, even though I'm one of the authors of Elixir. This will > > (hopefully) change soon. Of course, help on the project is always > > appreciated, and especially in that area... > > Actually, I quite like the Elixir API docs, having had a chance to > read through them. It's just that you have to dig 3 or 4 pages deep > from the index before you see details on mapping your objects, etc. If > there can just be some enhanced visibility of these pages, it might be > enough. > > Just a suggestion though: I think there's a slight overreliance on > referring to other technology, like "model objects following the > Active Record design pattern, and using a DSL syntax". It's speaking > to experts rather than beginners. I think that these terms will mean > nothing to many people who are just getting started and may make them > think that using Elixir is a complicated and jargon-filled task, when > in fact it's very simple. And it tells you what it is, as opposed to > what it does. > > A first draft at something I would consider better would be "Elixir > provides the ability to create simple Python classes that map directly > to relational database tables, providing many of the benefits of > traditional databases without losing the convenience of Python > objects. It is a declarative layer on top of the SQLAlchemy library, > and is modelled on the Active Record design pattern with a simple > syntax similar to that used by Ruby On Rails."
Well, in my case " It is a declarative layer on top of the SQLAlchemy library, and is modeled on the Active Record design pattern with a simple syntax similar to that used by Ruby On Rails," doesn't mean much either. ;-) Sad but true. I always feel like these "better" technologies tell me how much better they are than X but then want me to go learn X anyway so that I can understand why I should unlearn X. -- Ubuntu Linux DC LoCo Washington, DC http://dc.ubuntu-us.org/ --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
