Improve docs

[petforsberg]

For a lib with so many classes, docs are not self-explainatory. I don't know what is the reason and difference, for instance, between using DoctrineStorage and DoctrineQueryStorageProvider? Why should I use one over another? How classes relate to each other? What is the conceptual architecture desing for it? Docs should explain all of these.