Opened 15 years ago

Closed 15 years ago

Last modified 13 years ago

#12040 closed (fixed)

CurrentSiteManager documentation lacks indication when used in manytomany

Reported by: elpaso66 Owned by: Gabriel Hurley
Component: Documentation Version: 1.1
Severity: Keywords: sites framework manager
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

​http://docs.djangoproject.com/en/dev/ref/contrib/sites/

Should mention that the default field name for many-to-many is "sites" (plural) and not "site".

At least an example with m2m should show how to make it work:

on_site = CurrentSiteManager(field_name = 'sites')

Attachments (1)

12040_sites_docs.diff​ (3.9 KB ) - added by Gabriel Hurley 15 years ago.
Cleans up the docs in that area and adds information about "sites" vs. "site"

Download all attachments as: .zip

Change History (9)

comment:1 by Russell Keith-Magee, 15 years ago

milestone: → 1.2
Triage Stage: Unreviewed → Accepted

There are also some markup problems around this area - the site attribute is marked up as the class Site, which could be confusing.

comment:2 by Colin Copeland, 15 years ago

Owner: changed from nobody to Colin Copeland
Status: new → assigned

comment:3 by Colin Copeland, 15 years ago

Owner: changed from Colin Copeland to nobody
Status: assigned → new

by Gabriel Hurley, 15 years ago

Attachment: 12040_sites_docs.diff​ added

Cleans up the docs in that area and adds information about "sites" vs. "site"

comment:4 by Gabriel Hurley, 15 years ago

Has patch: set
Owner: changed from nobody to Gabriel Hurley
Status: new → assigned

I gave it my best go for cleaning up the docs there. Aside from noting about "sites" vs. "site" WRT ManyToManyFields and trying to sort out the all those :class: tags in there, I also corrected some awkward phrasings and bad line-wrapping.

comment:5 by Russell Keith-Magee, 15 years ago

Triage Stage: Accepted → Ready for checkin

comment:6 by Russell Keith-Magee, 15 years ago

Resolution: → fixed
Status: assigned → closed

(In [13168]) Fixed #12040 -- Cleaned up the documentation describing how CurrentSiteManager works. Thanks to elpaso66 for the report, and Gabriel Hurley for the draft patch.

comment:7 by Russell Keith-Magee, 15 years ago

(In [13174]) [1.1.X] Fixed #12040 -- Cleaned up the documentation describing how CurrentSiteManager works. Thanks to elpaso66 for the report, and Gabriel Hurley for the draft patch.

Backport of r13168 from trunk.

comment:8 by Jacob, 13 years ago

milestone: 1.2

Milestone 1.2 deleted

Note: See TracTickets for help on using tickets.
Back to Top