Bill de h�ra wrote:
[snip]
Lots of good comments. Many are editorial, and can simply be adopted by the editors without an explicit proposal, and for others you indicated that a Pace is forthcoming. I'll comment on a few that I believe require a Pace...
** 3.1.1 "type" Attribute
Replace:
[[[
If the value is "TEXT", the content of the Text construct MUST NOT contain child elements. Such text is intended to be presented to humans in a readable fashion. Thus, software MAY display it using normal text rendering techniques such as proportional fonts, white-space collapsing, and justification.
]]]
with:
"If the value is "TEXT", the content of the Text construct MUST NOT contain child elements. Such text is intended to be presented to humans in a readable fashion."
(I have more to say on @type later)
reason: we don't need to tell people what they can do with TEXT once we tell them what it is.
Often times the use of MAY is advisory to the producer. This is one of those cases: if you are expecting mono spaced fonts, you might want to consider using either HTML or XHTML and making the markup explicit.
** 3.5.1 Dereferencing Identity Constructs
[[[
... and it is suggested that the Identity construct be stored along with the associated resource.
]]]
problem: I didn't understand what that meant.
What we are trying to avoid is people generating unique ids every time a feed is fetched, as the real purpose of this element is for correlation to prior versions of the feed.
** 4.15 The "atom:content"
[[[ atom:entry elements MUST contain zero or one atom:content elements. ]]]
proposal: I would like this loosened to zero or more (a Pace is forthcoming). I have use cases to ship content about in Irish and English form - Zero or One means I need a private content model to support that.
I realize that you indicate that you intend to write a Pace on this. Just be aware that earlier drafts of Atom supported multiple content, and a lot of people seemed very motivated to eliminate this.
Are your requirements related to Atom being used for syndication or as a protocol?
-Sam Ruby
