Improve documentation

[SaurusXI]

The methods and their expected behaviour is lacking proper documentation. This package needs to do a better job of explaining the what each method does, what behaviour to expect with decorators, namespaces, cache eviction etc.