WIP - Work started to create yard documentation

I took it upon myself to start documenting Yaks.

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.