#16150: Syndication Feed docs incorrectly describe <link> tag.
----------------------+-------------------------------
Reporter: melinath | Owner: melinath
Type: Bug | Status: new
Milestone: | Component: Documentation
Version: SVN | Severity: Normal
Keywords: rss | Triage Stage: Unreviewed
Has patch: 1 | Easy pickings: 1
----------------------+-------------------------------
The current docs use the language "feed's link" when referring to the
dynamic "link" attribute, which is later used to generate the <link>
element of the rss channel. However, according to the RSS spec, <link> is
"The URL to the HTML website corresponding to the channel."
In Atom, the <link> element refers either to the corresponding HTML
website or to the feed itself, depending on whether the rel attribute is
set to "alternate" or "self" respectively. Django is consistent and uses
the dynamic "link" attribute for alternate, reserving "feed_url" for the
self reference.
So the docs are currently inaccurate. "link" is not used as the feed's url
- it's used as the url of the website corresponding to the feed. The
simplest way to fix it would be to change the language for the link
dynamic attr docs. However, it would probably be good to add feed_url to
the list of dynamic attrs, since the syndication code already looks for
it.
--
Ticket URL: <https://code.djangoproject.com/ticket/16150>
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 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.
