WIP - Work started to create yard documentation

I took it upon myself to start documenting Yaks. As I was anyway going over the code for our integration with the gem.

Please consider if this is a good idea, and let me know.

This is still a WIP and far from done. 

Also some of it is incorrect but will be improved as we go along.