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).
We are missing examples here, most confusion I've seen around the ORM is trying to see what the results where, so perhaps hinting how to debug the results might make help them