Added docco documentation

Now the class (and mixin) is extensively documented. Still missing some usage examples.