Graham wrote:
Introducing new terminology that everyone has to look up elsewhere in the document should be a last resort. If it's because we're defining head and entry separately then maybe we should notice they're 90% the same and do something about it.
Abstract ---------------------------------------- Recast atom:head as an entry.
Status ---------------------------------------- Open
Author: Robert Sayre
Rationale
----------------------------------------
It was productive to spec atom:feeds and atom:entries entirely separately, but now that we've done it, it seems they have a lot in common.
Atom Documents ---------------------------------------- Replace:
"An Atom Feed Document is a representation of an Atom feed, including metadata about the feed, and some or all of the entries associated with it. Its document element is atom:feed."
with
"An Atom Feed Document is a representation of an Atom feed, including an entry representing the feed itself, and some or all of the entries it contains. Its document element is atom:feed."
4 The "atom:feed" Element ---------------------------------------- Replace
"The 'atom:feed' element is the document (i.e., top-level) element of an Atom Feed Document, acting as a container for metadata and data associated with the feed. Its first element child MUST be atom:head, which MAY be followed zero or more atom:entry child elements."
with
"The 'atom:feed' element is the document (i.e., top-level) element of an Atom Feed Document, acting as a container for entries associated with the feed. It MUST contain one atom:headentry element, which MAY be followed zero or more atom:entry child elements."
4.2 The "atom:headentry" Element ----------------------------------------
Replace:
"The atom:head element acts as a container for metadata about the feed itself."
with:
"The 'atom:headentry' is an Atom Entry which provides a representation of the feed itself. The only additional restriction placed on atom:entry is that it MUST contain an atom:generator element."
----------------------------------------
Remove: 4.2.11 "atom:info" Element
----------------------------------------
Move: 4.2.3 "atom:introspection" Element to atom:entry
----------------------------------------
Move: 4.2.4 "atom:post" Element to atom:entry
"The 'atom:post' element is a Service construct that conveys the URI used to add entries to a feed which will have the parent entry as its headentry. atom:entry elements MUST NOT contain more than one atom:post element."
----------------------------------------
Make atom:tagline a child of atom:feed, which must appear before atom:headentry.
----------------------------------------
