I have been putting a lot of TLC into the ORM documentation this weekend getting ready for 5.0 to go Final. To that end I have put together a proposal for these changes, it is attached. I'd like to get some feedback. Thanks