#15504: Incorrect docs for args to SyndicationFeed.add_item
--------------------------------------------+-------------------------------
               Reporter:  slinkp@…          |         Owner:  nobody
                 Status:  reopened          |     Milestone:        
              Component:  Documentation     |       Version:  1.2   
             Resolution:                    |      Keywords:        
           Triage Stage:  Accepted          |     Has patch:  0     
    Needs documentation:  0                 |   Needs tests:  0     
Patch needs improvement:  0                 |  
--------------------------------------------+-------------------------------
Changes (by gabrielhurley):

  * stage:  Unreviewed => Accepted


Comment:

 Agreed that the two are inconsistent. Particularly it's
 `/ref/contrib/syndication/` that needs to be fixed. The first three
 arguments there are positional arguments, not keyword arguments, and it's
 worth enumerating the arguments as in the other doc linked.

 Moreover, the crossref targets for those docs are a total disaster.
 Neither
 `django.contrib.syndication.django.utils.feedgenerator.SyndicationFeed`
 nor `django.contrib.syndication.SyndicationFeed` exist. That whole section
 needs to be fixed up.

-- 
Ticket URL: <http://code.djangoproject.com/ticket/15504#comment:3>
Django <http://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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/django-updates?hl=en.

Reply via email to