ORM documentation re-structuring

Following a thread on cakephp-core and the work @Schlaefer has started, I've finished off the rest of the work (I think).
It might be good to mention here that this executes another query, so it gets "total hits" instead of the number of results in the page.

Adding another example to get the results in the result set object might be good