improving object permission documentation
adding documentation to decorators and mixins