<http://www.intertwingly.net/wiki/pie/PaceOrderCollectionsByAppModified>

== Abstract ==

Adds a new element {{{app:modified}}} to Atom Entries and spec that collection listings are ordered by {{{app:modified}}} instead of {{{atom:updated}}}.

== Author ==

Thomas Broyer

== Rationale ==

Being aware of ''insignificant changes'' (changes to a resource without modification of the {{{atom:updated}}} value) is necessary for clients with offline mode (they can't do a GET before editing an entry) to limit conflicts (particularly on mono-user systems, and not preventing them all) and enhance the user experience.

This hits the 80/20 mark.

== Proposal ==

In section 9, replace the second phrase with: {{{
The entries in the returned Feed MUST be ordered by their 'app:modified' property
(Section 10.3), with the most recently modified entries coming first in the
document order.
}}}

Change section 10 introduction to {{{
This specification adds one new value to the Registry of Link Relations and also adds two new element to Atom Entries called "app:control" for controlling publishing and "app:modified". These new links and extension elements MAY appear in both
membership lists and in member representations.
}}}

Add the following to section 10:

=== 10.3 The app:modified element ===

This specification defines a new child element of Atom Entries to carry the instant in time when they were last modified.

{{{
pubModified =
  element app:modified { atomDateConstruct }
}}}

The "app:modified" element is a Date construct as defined in [AtomFormat].

The "app:modified" element MAY appear as a child of an "atom:entry" which is being created or updated via the Atom Publishing Protocol. The "app:modified" element, if it does appear in an entry, MUST only appear at most one time. When listing a collection membership, if the "app:modified" element does not appear in an entry, implementations MUST treat the entry as if the element were present with a value equal to the one of the "atom:updated" element.

The "app:modified" element MAY be included in Atom Feed or Entry Documents. The "app:modified" element is considered "foreign markup" as defined in Section 6 of the Atom Syndication Format.

== Impacts ==

Adds a new property to Atom Entries; equivalent to the Last-Modified HTTP header.

== Notes ==

Discussion on the atom-protocol list [http://www.imc.org/atom-protocol/mail-archive/msg02154.html here]

----

CategoryProposals


Reply via email to