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 25485 Deprecation notice on GenericRelation is confusing Joey Wilhelm nobody "In looking up the documentation for GenericRelation, I ran across the deprecation notice which looks like: class GenericRelation Deprecated since version 1.7: This class used to be defined in django.contrib.contenttypes.generic. Support for importing from this old location will be removed in Django 1.9. This was initially confusing to me for two reasons. To alleviate repetition, here's the related conversation from IRC: < TheJoey> Is it just me, or is this deprecation notice a bit confusing? https://docs.djangoproject.com/en/1.8/ref/contrib/contenttypes/#reverse-generic-relations < moldy> TheJoey: not to me < TheJoey> moldy: It makes it sound to me, at first, like GenericRelation itself is deprecated. And then it goes on to say that the old location will be removed, but not where the new location is. < moldy> TheJoey: i do wish that the reference docs would say ""class the.import.path.Object"" in these headings (the
), but that's a more general issue < giarc> TheJoey a little... it'd be nice to have the current import location mentioned < TheJoey> moldy: Or at least showing more import statements in the example code < TheJoey> Problem is, just looking at this doc, I have no idea where to pluck GenericRelation from. Except that I just read something earlier today about that particular deprecation, so I already have an idea where to look. Perhaps this could be stated more along the lines of ""This class definition was moved from django.contrib.contenttypes.generic to django.contrib.contenttypes.fields"", or the example below could actually show the import." Cleanup/optimization closed Documentation 1.8 Normal fixed moldy Accepted 1 0 0 0 0 0