Joe Gregorio wrote:
Section 9: """Clients SHOULD be constructed with this in mind and
SHOULD perform a GET on the member resource before editing."""
Overlooked that, thanks. I'd like to see it made more prominent (up in
the section that describes the editing process) ... but whatever.
Section 2, 3 & 6: Move to sections 1.1, 1.2 and 1.3
Section 1 is "Introduction". Sections 2, 3 & 6 are
"Notational Conventions", "Terminology" and "XML-related Conventions"
respectively. I don't see those sections as 'introductory'.
Not a big deal, obviously, just a style preference. I think it would
definitely help the document flow tho.
And it's not like there isn't precedence for it ;-)
http://www.atompub.org/2005/08/17/draft-ietf-atompub-format-11.html
http://www.faqs.org/rfcs/rfc2616.html
Section 7: Instead of "discover capabilities and locations" make it
"discover the locations of available collections along with associated
metadata". Collections do not have capabilities.. at least none that we
are defining.
Collections may either be media or entry collections, that is,
they have the 'capability' to handle different media types.
That's a stretch. What a container can contain is a property of the
container, not a capability of the container. To me, a capability would
be something like, "the collection can send notifications when a new
member is added" or "the collection can hold the publication of an entry
until a specified date and time", or "the collection can run tidy on the
html content of an entry" or "the collection can apply image processing
filters to images posted to the media collection".
Section 7.2: Can we use application/atompub+xml for the media type instead?
I'm not tied to a name, but I also don't want to change just
for the sake of changing. Do you have a specific reason *not* to use atomserv?
What, being anal is not a good enough reason? ;-) (kidding of course).
Just an editorial / style preference... much like the naming of "media
collections" vs. "generic collections".
You can not change the title of a media collection member
once it has been created.
Yikes. really? Better be darn sure you run that spellchecker then.
- James
