Drupal ORM Module Up and Running

Hi Brendon:

Thanks for writing this module! I just downloaded it and am taking a look at it.

The first thing I noticed was a scarcity of documentation - on the project page, in the admin section after the module was installed, or anywhere online. I just cracked open the module and its implementation isn't clear at all.

I know you put up a few examples on your project page, which probably look very clear to you, but an example of how to specify data for CCK fields, Taxonomy, etc of a node being saved would be great for the rest of us. Typically what happens for someone who's been creating something like this is that once you're done it's incredibly obvious to YOU how it works... but that's because your head's been in it for X weeks.

If you want this module to gain wide usage I recommend writing documentation that is VERY simple and straightforward and comprehensive.

There's my feedback thus far.

You said above you were looking for feedback on this module so I've got a bit more...

I've been successfully using it to save nodes after doing a bit of digging and figuring out the right code. Now I've tried to use it to search nodes and it's a bit frustrating. I'm especially unclear how to use your mechanism when I've got to join in another table or two in the search...

I willing to help to provide code document.

So, anybody has written documentation yet?
I am new to ORM. I know a little bit about DBIx::Class in Perl and currently looking at Doctrine 2.
Anybody has used both PHP ORMs and Drupal ORM? Any cons and pros?