datatracker.ietf.org
Sign in
Version 5.3.0, 2014-04-12
Report a bug

The 'describes' Link Relation Type
RFC 6892

Independent Submission                                          E. Wilde
Request for Comments: 6892                               EMC Corporation
Category: Informational                                       March 2013
ISSN: 2070-1721

                   The 'describes' Link Relation Type

Abstract

   This specification defines the 'describes' link relation type that
   allows resource representations to indicate that they are describing
   another resource.  In contexts where applications want to associate
   described resources and description resources, and want to build
   services based on these associations, the 'describes' link relation
   type provides the opposite direction of the 'describedby' link
   relation type, which already is a registered link relation type.

Status of This Memo

   This document is not an Internet Standards Track specification; it is
   published for informational purposes.

   This is a contribution to the RFC Series, independently of any other
   RFC stream.  The RFC Editor has chosen to publish this document at
   its discretion and makes no statement about its value for
   implementation or deployment.  Documents approved for publication by
   the RFC Editor are not a candidate for any level of Internet
   Standard; see Section 2 of RFC 5741.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc6892.

Copyright Notice

   Copyright (c) 2013 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.

Wilde                         Informational                     [Page 1]
RFC 6892                  describes" Link Type                March 2013

Table of Contents

   1. Introduction ....................................................2
   2. Resource Descriptions ...........................................2
   3. Use Case ........................................................3
   4. IANA Considerations .............................................4
   5. Security Considerations .........................................4
   6. Acknowledgements ................................................4
   7. References ......................................................5
      7.1. Normative References .......................................5
      7.2. Informative References .....................................5

1.  Introduction

   Resources on the web can be identified by any (registered) URI scheme
   and can be represented by any (registered) media type.  In many
   cases, applications establish specific (i.e., typed) relations
   between the resources they are concerned with, which can either be
   under their control or controlled by another authority.  A common
   usage pattern for associating resources is to have resources that are
   descriptions of other resources.  This specification registers the
   'describes' link relation, which allows applications to represent the
   fact that one resource is a description of another resource.

   RFC 5988 [1] "defines a framework for typed links that isn't specific
   to a particular serialisation or application.  It does so by
   redefining the link relation registry established by Atom to have a
   broader domain, and adding to it the relations that are defined by
   HTML".  This registration request intends to augment the link
   relation registry with a link relation that is the inverse of the
   already registered 'describedby' relation, so that links between
   described resources and describing resources can be represented in
   both directions.

2.  Resource Descriptions

   Associating resources with descriptions of these resources is a
   recurring pattern on the web.  The IANA "Link Relations" registry
   established by RFC 5988 [1] currently contains a 'describedby' link
   relation type, which has been registered by POWDER [2].  The
   definition given in the reference document for that registration is
   as follows: "The relationship A 'describedby' B asserts that resource
   B provides a description of resource A.  There are no constraints on
   the format or representation of either A or B, neither are there any
   further constraints on either resource".

Wilde                         Informational                     [Page 2]

[include full document text]