< draft-amundsen-item-and-collection-link-relations-04.txt   draft-amundsen-item-and-collection-link-relations-05.txt >
Network Working Group M. Amundsen Network Working Group M. Amundsen
Internet-Draft October 9, 2011 Internet-Draft February 5, 2012
Intended status: Informational Intended status: Informational
Expires: April 11, 2012 Expires: August 8, 2012
The Item and Collection Link Relations The Item and Collection Link Relations
draft-amundsen-item-and-collection-link-relations-04 draft-amundsen-item-and-collection-link-relations-05
Abstract Abstract
RFC 5988 [RFC5988] standardized a means of indicating the RFC 5988 standardized a means of indicating the relationships between
relationships between resources on the Web. This specification resources on the Web. This specification defines a pair of reciprocal
defines a pair of reciprocal link relation types that may be used to link relation types that may be used to express the relationship
express the relationship between a collection and its members. between a collection and its members.
Editorial Note (To be removed by RFC Editor) Editorial Note (To be removed by RFC Editor)
Distribution of this document is unlimited. Comments should be sent Distribution of this document is unlimited. Comments should be sent
to the IETF Apps-Discuss mailing list (see to the IETF Apps-Discuss mailing list (see
<https://www.ietf.org/mailman/listinfo/apps-discuss>). <https://www.ietf.org/mailman/listinfo/apps-discuss>).
Status of This Memo Status of This Memo
This Internet-Draft is submitted to IETF in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF). Note that other groups may also distribute
other groups may also distribute working documents as Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at This Internet-Draft will expire on August 8, 2012.
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on April 11, 2012.
Copyright Notice Copyright Notice
Copyright (c) 2011 IETF Trust and the persons identified as the Copyright (c) 2012 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the BSD License. described in the Simplified BSD License.
1. Introduction 1. Introduction
RFC 5988 [RFC5988] standardized a means of indicating the RFC 5988 standardized a means of indicating the relationships between
relationships between resources on the Web. This specification resources on the Web. This specification defines a pair of reciprocal
defines a pair of reciprocal link relation types that may be used to link relation types that may be used to express the relationship
express the relationship between a collection and its members. between a collection and its members.
These link relation types can be applied to a wide range of use cases These link relation types can be applied to a wide range of use cases
across multiple media types. For example, the 'collection' and across multiple media types. For example, the 'collection' and
'item' link relation types are used in these media types: 'item' link relation types are used in these media types:
1. OpenSearch 1.1: see Section 4.5.4.1 of [OpenSearch] 1. OpenSearch 1.1: see Section 4.5.4.1 of [OpenSearch]
2. Maze+XML: see Section 3 of [Maze] 2. Maze+XML: see Section 3 of [Maze]
3. Collection+JSON: see Section 5 of [CollectionJSON] 3. Collection+JSON: see Section 5 of [CollectionJSON]
skipping to change at page 4, line 5 skipping to change at page 3, line 38
<a href="..." rel="collection">View other widgets</a> <a href="..." rel="collection">View other widgets</a>
<a href="..." rel="collection">View all discontinued items</a> <a href="..." rel="collection">View all discontinued items</a>
The target resource representation need not be restricted to The target resource representation need not be restricted to
representing a list. It may simply be a document that provides representing a list. It may simply be a document that provides
details on the collection of which the context resource is a member: details on the collection of which the context resource is a member:
Link: <...>; rel="collection"; Link: <...>; rel="collection";
title="Shakespeare's Collected Works - A History" title="Shakespeare's Collected Works - A History"
It should also be noted that that same link might represent an 'item'
in one collection as well as a 'collection' itself. In this case
both Link Relation values can be applied to the same link:
Link: <...>; rel="collection item";
title="A Review of Issac Asimov's Collected Works - Vol. I"
3. IANA Considerations 3. IANA Considerations
IANA is asked to register the 'collection' and 'item' Link Relations IANA is asked to register the 'collection' and 'item' Link Relations
below as per [RFC5988]. below as per [RFC5988].
3.1. 'item' Link Relation Registration 3.1. 'item' Link Relation Registration
Relation Name: Relation Name:
item item
skipping to change at page 4, line 42 skipping to change at page 4, line 37
The target IRI points to a resource which represents a collection The target IRI points to a resource which represents a collection
of which the context IRI is a member. of which the context IRI is a member.
Reference: Reference:
See Section 2 See Section 2
4. Security Considerations 4. Security Considerations
The two link relation types defined in this document are not believed The two link relation types defined in this document do not introduce
to introduce any new security issues to those which are discussed in any new security issues to those which are discussed in Section 7 of
Section 7 of RFC5988 [RFC5988]. RFC5988 [RFC5988].
5. Internationalisation Considerations 5. Internationalisation Considerations
The 'item' and 'collection' link relation types do not have any The 'item' and 'collection' link relation types do not have any
internationalization considerations other than those which are internationalization considerations other than those which are
discussed in Section 8 of RFC5988 [RFC5988]. discussed in Section 8 of RFC5988 [RFC5988].
6. References 6. References
6.1. Normative References 6.1. Normative References
[RFC5988] Nottingham, M., "Web Linking", RFC 5988, [RFC5988] Nottingham, M., "Web Linking", RFC 5988,
October 2010. October 2010.
6.2. Informative References 6.2. Informative References
[OpenSearch] Clinton, D., "Open Search 1.1", Work in Progress , [OpenSearch] Clinton, D., "Open Search 1.1", Work in Progress ,
March 2011, <http://www.opensearch.org/ March 2011, <http://www.opensearch.org/
Specifications/OpenSearch/1.1/>. Specifications/OpenSearch/1.1/>.
 End of changes. 13 change blocks. 
27 lines changed or deleted 29 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/