Clearly document use on methods

[mikeboers]

Right now it is not documented well (or at all) how to decorate class methods.

This is particular tricky with regards to how keys are generated from instances (they are repred).