Reorganize the documentation

Will close issue #257 and #273 
The keys here (e.g. `Doctrine ORM`, `Propel`) should maybe be the keys that you'd use below with `db_driver` (e.g. `orm`, `propel`).