added notes on managing @cached_property, other uses of it