Issues with "Models"-Documentation
|Reported by:||david-schultz@…||Owned by:||nobody|
|Severity:||Normal||Keywords:||Documentation Models Minor|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
reading that file (https://docs.djangoproject.com/en/1.5/topics/db/models/) , I found two things that probably should be replaced:
Section "Many-to-one relationships" has a paragraph:
"You can also create recursive relationships (an object with a many-to-one relationship to itself) and relationships to models not yet defined; see the model field reference for details." (Bold by me.)
To me, the term "object" is confusing at this point, as I understand it as being an instance of the class, whereas you are clearly talking about a relationship between different instances of the same class. However, you use this terminology at other places as well, so I am not quite sure about this, since I also am rather new to Python and especially Django.
Second Code example of section "Extra fields on many-to-many relationships" ends with:
>>> m2 = Membership.objects.create(person=paul, group=beatles, ... date_joined=date(1960, 8, 1), ... invite_reason= "Wanted to form a band.") >>> beatles.members.all() [<Person: Ringo Starr>, <Person: Paul McCartney>]
I'm sure you forgot a m2.save() before calling beatles.members.all().