[Dbix-class] Patch to Intro.pod

[Adam Jacob]

mst and I had a conversation on IRC earlier today, wherein I was  
complimenting DBIx::Class's ResultSet approach.  It took a good bit  
of experimenting to wrap my head around, but I'm totally sold on it now.

He mentioned that it would be helpful to see if I could find a way to  
distill that for the documentation, and attached is my attempt to do  
so.  I've added section to the top of  DBIx::Class::Manual::Intro,  
titled "The DBIx::Class Way".

The intent is to put in front of perspective users, right away,  
exactly how DBIx::Class want's you to think about dealing with your  
Database.  Things I covered:

* Tables become ResultSources
    A ResultSource == Table

* It's all about the ResultSet
    Any time you would reach for a SQL query in DBI, you are creating a
    DBIx::Class::ResultSet.

* Search is like "prepare"
    Setting up a ResultSet does not execute the query; retrieving the  
data does.

The patch is attached; hope it helps.  (And that we add more simple  
principles to the Intro!)

Adam

-------------- next part --------------
A non-text attachment was scrubbed...
Name: DBIx-Class-Way-Intro.patch
Type: application/octet-stream
Size: 2423 bytes
Desc: not available
Url : http://lists.rawmode.org/pipermail/dbix-class/attachments/20060602/aae92b74/attachment.obj