Re^2: Class::DBI vs. DBIx::Class


Perl Monk, Perl Meditation
	PerlMonks

Re^2: Class::DBI vs. DBIx::Class

by ryantate (Friar)

on Jun 26, 2006 at 20:42 UTC ( [id://557657]=note: print w/replies, xml )

Need Help??

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

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.

Comment on Re^2: Class::DBI vs. DBIx::Class

Replies are listed 'Best First'.

Re^3: Class::DBI vs. DBIx::Class
by siracusa (Friar) on Jun 28, 2006 at 00:25 UTC

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

[reply]

In Section Seekers of Perl Wisdom