Slight modification that hopes to clarify the "linked media resource"
... which is meant in terms of "Media Link Entries and Media Resources";
and to provide an app:revision element which associates an opaque
revision token with an entry.
- James
#pragma section-numbers off
== Abstract ==
For Draft -09
== Status ==
Proposed
== Rationale ==
Having a way of indicating the date the entry was last modified is a
good optimization to avoid having to HEAD each individual member URI to
get the Last-Modified header. The element is also useful for detecting
minor changes that do not impact the value of atom:updated.
Having a way of associating a unique revision token with an entry is
also useful.
== Proposal ==
{{{
8.# The "app:modified" Element
The "app:modified" element is a Date construct as defined by [RFC4287] whose
value indicates the most recent instant in time when an entry was
modified in
any way. Atom entry elements MAY contain one "app:modified" element.
appModified = element app:modified ( atomDateConstruct )
Publishers MUST change the value of this element every time a collection
member
resource has been updated and SHOULD change the value of this element
whenever an associated Media Resource has been modified.
8.# The "app:revision" Element
The "app:revision" element provides an opaque token that can be used to
identify
the state of an atom:entry. Atom entry elements MAY contain one
"app:revision"
element.
appRevision = element app:revision { text }
Publishers MUST change the value of this element every time a collection
member
resource has been updated and SHOULD change the value of this element
whenever an associated Media Resource has been modified.
}}}
== Impacts ==
Very little. Use of the elements are optional.
== Notes ==
Example:
{{{
<entry xmlns="http://www.w3.org/2005/Atom"; xmlns:app="...">
<id>urn:lsid:example.org:entries:1</id>
<updated>2006-07-11T12:12:12Z</updated>
<app:revision>urn:lsid:example.org:entries:1:2</app:revision>
<app:modified>2006-07-11T12:13:13Z</app:modified>
...
</entry>
}}}
(Note that app:revision and app:modified play a similar role as atom:id
and atom:updated)
----
CategoryProposals
