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." -- Ben Sizer --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
