#21246: Issues with "Models"-Documentation
-------------------------------------+-------------------------------------
Reporter: david-schultz@… | Owner: nobody
Type: | Status: new
Cleanup/optimization | Version: 1.5
Component: Documentation | Keywords: Documentation Models
Severity: Normal | Minor
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Hello guys,
reading that file
(https://docs.djangoproject.com/en/1.5/topics/db/models/) , I found two
things that probably should be replaced:
'''
1.'''
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.
'''
2.'''
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()''.
Best regards
David
--
Ticket URL: <https://code.djangoproject.com/ticket/21246>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/064.0ce18619dbdc3ff232b30a02ea2e98b9%40djangoproject.com.
For more options, visit https://groups.google.com/groups/opt_out.
