http://www.perlmonks.org?node_id=557613


in reply to Class::DBI vs. DBIx::Class

While the original question was about CDBI versus DBIC, I think it is probably worth mentioning Rose::DB::Object. It has many of the features of CDBI and DBIC, is faster for many tasks, and also has an active user community (and author). Most importantly for me, it has absolutely FANTASTIC documentation!

Sean

Replies are listed 'Best First'.
Re^2: Class::DBI vs. DBIx::Class
by ryantate (Friar) on Jun 26, 2006 at 20:42 UTC
    Most importantly for me, it has absolutely FANTASTIC documentation

    Disagree very strongly. But supposedly the author is aware of the issues and the "tutorial" may be rewritten some day, so I'm reluctant to throw any specific rocks.

      I've gotten requests for a "quick-start" guide, which I plan to add. I also plan to add a FAQ and/or a "how-to" guide for common questions and tasks.

      My baseline for any release is 100% complete reference documentation, meaning every method and all its options are documented. For people who learn best from reference-style documentation, this is extremely helpful. Worst case, someone can post to the mailing list and I can point out which part of the documentation to read.

      But with a very big, feature-rich module, it's hard for some people to find a "way in," so to speak. The existing tutorial was my first step towards helping with that, providing a narrative-style exploration of the major features as well as examples of best practices. I think the quick-start guide will be next.

      If anyone has any more suggestions, just email me or post to the mailing list