Fix some documentation warnings and document @cached_property in reference