> Introductory documentation is Sequel's weakest area, IMO. The RDoc > documentation is fairly comprehensive, but admittedly terse in a lot > of areas. >
I was (and still is in some aspect) a beginner with Sequel, and i would agree that it took me a bit to understand sequel. Could also be my bias background in ActiveRecord (the old one). Let me try to recall what i was stumbling on the most... On Apr 14, 11:30 am, Jeremy Evans <[email protected]> wrote: > On Apr 13, 3:39 pm, Shawn <[email protected]> wrote: > > > Jeremy, > > > You've done a great job maintaining and expanding this library. At > > this point, I think it needs adoption and community more than new > > features. With Rails 3 now supporting ORM choice, Sequel has an > > opportunity and a challenge: Rails now allows ORM choice, and > > ActiveRecord AREL is claiming Sequel's long-time features as its own. > > It's an excellent time to make the case for Sequel by improving its > > web presence and online promotion, including: > > > * A new web site to organize all the docs and examples in one place > > http://sequel.rubyforge.org/documentation.htmlpretty much does this. > I'm certainly willing to consider design changes to make it more user > friendly, though I'm not sure what they'd be. > > > * More documentation: entry-level and advanced, from intro to > > comprehensive > > Introductory documentation is Sequel's weakest area, IMO. The RDoc > documentation is fairly comprehensive, but admittedly terse in a lot > of areas. > > Unfortunately, people are not specific when they ask for introductory > documentation, and not being a beginner, I'm not sure what the basic > stumbling blocks for new users are. If you could give a rough outline > of the documentation you'd like to see, I could probably work on it. > > > * An updated/more attractive logo (these things do influence > > perception) > > Not being a graphic designer myself, this isn't something I'm > qualified to do. However, if someone were to provide a better logo, I > would not have a problem changing. > > > I'd be happy to help with this, but I may not be able to contribute a > > lot until next month. > > I would definitely appreciate the help. > > Thanks, > Jeremy -- You received this message because you are subscribed to the Google Groups "sequel-talk" 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/sequel-talk?hl=en.
