Is there going to be some rather in-depth documentation to explain all of this kind of thing?

It is taking a while for me to get my head round it all.