On 17/10/2005, at 5:14 PM, James M Snell wrote:
Hmm.. better than before. It would be better if you left it at the
"at the time it was minted" part and left out the sentence that
follows. But I can live with it.
That phrase is probably redundant. Which leaves:
- Attribute Value: previous
- Description: A stable URI that, when dereferenced, returns a
feed document containing a set of entries that sequentially precede
those in the current document. This can be thought of as specific to
those entries; in other words, it represents a fixed section of the
feed, rather than a sliding window over it. Note that the exact
nature of the ordering between the entries and documents containing
them is not defined by this relation; i.e., this relation is only
relative.
- Expected display characteristics: Undefined.
- Security considerations: Because automated agents may follow
this link relation to construct a 'virtual' feed, care should be
taken when it crosses administrative domains (e.g., the URI has a
different authority than the current document). Such agents should
also take care to detect circular references between feeds when
following them.
- Attribute Value: next
- Description: A stable URI that, when dereferenced, returns a
feed document containing a set of entries that sequentially follow
those in the current document. This can be thought of as specific to
those entries; in other words, it represents a fixed section of the
feed, rather than a sliding window over it. Note that the exact
nature of the ordering between the entries and documents containing
them is not defined by this relation; i.e., this relation is only
relative.
- Expected display characteristics: Undefined.
- Security considerations: Because automated agents may follow
this link relation to construct a 'virtual' feed, care should be
taken when it crosses administrative domains (e.g., the URI has a
different authority than the current document). Such agents should
also take care to detect circular references between feeds when
following them.
- Attribute Value: first
- Description: A stable URI that, when dereferenced, returns a
feed document containing those entries furthest preceding those in
the current document. This can be thought of as specific to those
entries; in other words, it represents a fixed section of the feed,
rather than a sliding window over it. Note that the exact nature of
the ordering between the entries and documents containing them is not
defined by this relation; i.e., this relation is only relative.
- Expected display characteristics: Undefined.
- Security considerations:
- Attribute Value: last
- Description: A stable URI that, when dereferenced, returns a
feed document containing those entries furthest following those in
the current document. This can be thought of as specific to those
entries; in other words, it represents a fixed section of the feed,
rather than a sliding window over it. Note that the exact nature of
the ordering between the entries and documents containing them is not
defined by this relation; i.e., this relation is only relative.
- Expected display characteristics: Undefined.
- Security considerations:
- Attribute Value: subscribe
- Description: A stable URI that, when dereferenced, returns a
feed document containing a set of the most recent entries in the
feed. This URI is intended to be subscribed to to keep abreast of
changes in the feed. When different from the URI of the feed document
it exists in, it indicates a URi that should be used for this purpose
in place of the current document's URI.
- Expected display characteristics: Undefined.
- Security considerations: Users should always be informed of the
actual URI they are subscribing to, and subscription should only take
place when it is explicitly requested.
One other thought; what about "first-entries", "next-entries",
"previous-entries", "last-entries"?
--
Mark Nottingham http://www.mnot.net/
