id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
20870	django.utils.functional.cached_property should be documented	Daniele Procida	nobody	"It's a very common pattern in Django to find oneself calling a method in a view to check something - `if MyModel.mymethod():` - then a moment later in the template `{% for things in mymodel.mymethod %}` - so `mymethod()` gets called twice.

If ``mymethod()` is very expensive, this could be a problem.

`django.utils.functional.cached_property` already exists and solves the problem. Doesn't it deserve to be documented so that we can all enjoy it?

https://github.com/django/django/blob/master/django/utils/functional.py#L38"	New feature	closed	Documentation	1.5	Normal	fixed		info@…	Accepted	0	0	0	0	0	0