Ticket 20870 - document @cached_property

Replaces closed pull request https://github.com/django/django/pull/1449

https://code.djangoproject.com/ticket/20870
https://groups.google.com/forum/#!topic/django-developers/MytkDIgZ9kA