Reorganize the documentation

Will close issue #257 and #273 
>
Doctrine ORM as the persistence engine on the examples. Though mostly, there won't be much difference if you use a different engine.