One document matched: draft-snell-more-link-relations-01.xml

<?xml version="1.0"?> 
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
  <!ENTITY rfc5988 PUBLIC '' 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.5988.xml'>
]>
<?rfc toc="yes"?> 
<?rfc strict="yes"?> 
<?rfc symrefs="yes" ?> 
<?rfc sortrefs="yes"?> 
<?rfc compact="yes"?> 
<rfc category="info" ipr="trust200811" docName="draft-snell-more-link-relations-01"> 
  <front> 
    <title abbrev="More Link Relations"> 
      Additional Link Relations and the urn:social Namespace
    </title> 
 
    <author initials="J.M." surname="Snell" fullname="James M Snell"> 
      <address> 
        <email>jasnell@gmail.com</email> 
      </address> 
    </author> 
    
    <date month="September" year="2013" /> 
 
    <area>Applications</area> 
    <keyword>I-D</keyword> 
    <keyword>http</keyword> 
    <keyword>link</keyword> 
    <keyword>rel</keyword>
 
    <abstract> 
      <t>
        This specification defines a number of additional 
        Link Relation Types that can used for a variety of 
        purposes..</t> 
    </abstract> 
 
  </front> 
  
  <middle> 
    <section anchor="intro" title="Introduction"> 
 
      <t>
        This specification defines and adds the following additional 
        link relation types to the IANA Registry of Link Relations
        established by <xref target="RFC5988"/>: to, bto, cc, bcc, 
        from, bfrom, source, generator, provider, location, alias and
        mentionedBy. Further, this specification proposes a new 
        'social' URN namespace.
      </t>
      
      <t>
        Note that this document is a work-in-progress draft specification
        that does not yet represent a "standard". It is the intention of 
        this specification to propose a few new ideas and openly solicit 
        feedback on their definition and use. While this document might 
        eventually evolve into an RFC the ideas described herein have not 
        yet been broadly implemented and have definitions that may evolve
        through successive iterations of this draft.
      </t>
      
    </section> 
    
    <section title="The 'social' URN Namespace">
      
      <t>
        This specification defines the 'social' URN namespace having the 
        following structure:
      </t>
      
      <figure><artwork>urn:social:{NSS}</artwork></figure>
      
      <t>
        The Namespace Specific String (NSS) MUST be one of:
        <list style="symbols">
          <t>everyone</t>
          <t>direct</t>
          <t>extended</t>
          <t>peer</t>
          <t>subordinate</t>
          <t>superior</t>
          <t>common</t>
          <t>interested</t>
          <t>self</t>
        </list>
      </t>
      
      <t>
        Within any given social networking system, there is an available
        population of entities. Each NSS term represent specific subsets of 
        this population and are defined in terms of these subsets relative 
        to a fixed context. For example, if the fixed content is a person,
        the "urn:social:direct" URN identifies the subset of the total 
        population that is directly connected to the context person within 
        the social graph, while the "urn:social:extended" URN identifies the
        subset that is directly or indirectly connected to the context 
        person.
      </t>
      
      <t>
        The 'social' URN namespace is defined to be intentionally 
        ambiguous and contextually dependent. The specific interpretation
        of each NSS depends entirely on how and where the NSS is being 
        used.
      </t>
      
      <section title="urn:social:everyone">
        <t>
          The "urn:social:everyone" URN identifies the subset of the total
          population that is visible to the context.
        </t>
      </section>
      
      <section title="urn:social:direct">
        <t>
          The "urn:social:direct" URN identifies the subset of the total
          population that is both visible to and directly connected to 
          the context.
        </t>
      </section>
      
      <section title="urn:social:extended">
        <t>
          The "urn:social:extended" URN identifies the subset of the total
          population that is visible to and connected either directly or 
          indirectly to the context.
        </t>
      </section>
      
      <section title="urn:social:peer">
        <t>
          The "urn:social:peer" URN identifies the subset of the total
          population that is both visible to the context and considered 
          to be a "peer".
        </t>
        <t>
          Peer relationships exist only within populations
          in which there exists a hierarchical division of members in 
          the population. An example of such a network would be a company or 
          similarly structured organization. Peers might be directly 
          or indirectly connected to the target resource but are considered 
          to share the same hierarchical position.
        </t>
      </section>
      
      <section title="urn:social:subordinate">
        <t>
          The "urn:social:subordinate" URN identifies the subset of the
          total population that is both visible to the context and 
          considered to be "subordinate" to the context.
        </t>
        <t>
          Subordinate relationships exist only within populations in which 
          there exists a hierarchical division of members in the population. 
          An example of such a network would be a company or similarly structured
          organization. Subordinates might be directly or indirectly connected 
          to the target resource but are considered to share a lower hierarchical 
          position.
        </t>
      </section>
      
      <section title="urn:social:superior">
        <t>
          The "urn:social:superior" URN identifies the subset of the
          total population that is both visible to the context and 
          considered to be "superior" to the context.
        </t>
        <t>
          Superior relationships exist only within populations in which there 
          exists a hierarchical division of members in the population. An example of
          such a network would be a company or similarly structured
          organization. Superiors might be directly or indirectly connected to 
          the target resource but are considered to have a higher hierarchical 
          position.
        </t>
      </section>
      
      <section title="urn:social:common">
        <t>
          The "urn:social:common" URN identifies the subset of the total
          population that is both visible to the context and 
          is determined to share the same common attributes as the 
          context.
        </t>
        <t>
          Determination of "common attributes" is dependent entirely on the
          application. For example, an application might choose to use shared
          interests in a given topic as the "common attribute" binding a 
          particular grouping of members.
        </t>
      </section>
      
      <section title="urn:social:interested">
        <t>
          The "urn:social:interested" URN identifies the subset of the 
          total population that is both visible to the context and has 
          an express interest in the context. Examples of members of the
          "interested" subset are those who have elected to "follow" the
          activity of the context resource.
        </t>
      </section>
      
      <section title="urn:social:self">
        <t>
          The "urn:social:self" URN identifies the context resource 
          itself as a member of the total population.
        </t>
      </section>
      
    </section>
                              
    <section title="IANA Considerations"> 
      
      <t>
        The following Link Relations are added to the IANA Registry of 
        Link Relations.
      </t>
      
      <texttable>
        <ttcol>Name</ttcol>
        <ttcol>Description</ttcol>
        
        <c>to</c>
        <c>
          Refers to a resource that is considered to be part of the
          public primary audience of the link's context.
        </c>
        
        <c>bto</c>
        <c>
          Refers to a resource that is considered to be part of the
          private primary audience of the link's context.
        </c>
        
        <c>cc</c>
        <c>
          Refers to a resource that is considered to be part of the 
          public secondary audience of the link's context.
        </c>
        
        <c>bcc</c>
        <c>
          Refers to a resource that is considered to be part of the 
          private secondary audience of the link's context.
        </c>
        
        <c>from</c>
        <c>
          Refers to a resource that is publicly considered to be the originator
          of the link's context.
        </c>
        
        <c>bfrom</c>
        <c>
          Refers to a resource that is privately considered to be the orignator
          of the link's context.
        </c>
        
        <c>source</c>
        <c>
          Refers to the original source of information contained by the 
          context resource.
        </c>
        
        <c>provider</c>
        <c>
          Refers to the resource that provided the context resource. 
          Typically, this would be used to identify the entity publishing
          the resource. 
        </c>
        
        <c>generator</c>
        <c>
          Refers to the resource that generated the context resource.
          Typically, this would be used to identify the software application
          that created the context resource.
        </c>
        
        <c>mentionedBy</c>
        <c>
          Refers to a resource that mentions the context resource in some 
          fashion. This, for example, would be used when an article mentions
          another article, or a social status update mentions a particular
          user, etc.
        </c>
        
        <c>location</c>
        <c>
          References a URI/IRI that represents a physical or logical location
          with which the context resource is associated.
        </c>
        
      </texttable>
            
    </section> 
 
    <section title="Security Considerations"> 
    
      <t>There are no additional security concerns introduced by this
      document.</t>
    
    </section> 
  </middle> 
 
  <back>
    <references title="Informative References">
      &rfc5988;
    </references>
    
    <section title="Examples">
    
      <figure><preamble>Using targeting link relations and the urn:social namespace:</preamble><artwork><![CDATA[
    POST /alerts HTTP/1.1
    Host: example.org
    Content-Type: text/plain
    Authorization: Basic {Base64 Credentials}
    Link: <urn:social:everyone>; rel="to"
    Link: <urn:social:extended>; rel="cc"
    Link: <urn:social:self>; rel="bfrom"
  
    Test message
      ]]></artwork></figure>
    
 
      <figure><preamble>Using publication link relations:</preamble><artwork><![CDATA[
    <html>
      <head>
        ...
        <link 
          rel="source" 
          href="http://example.net/post/1" />
        <link 
          rel="provider" 
          href="http://example.org" />
        <link 
          rel="generator" 
          href="http://example.com/software/app/1.1" />
        ...
      </head>
      <body>...</body>
    </html>
  

      ]]></artwork></figure>
    
      <figure><preamble>Using the alias and location relations:</preamble><artwork><![CDATA[
    Link: <geo:37.786971,-122.399677>; rel="location"
      ]]></artwork></figure>
    
      <figure><preamble>Using the mentionedBy relation:</preamble><artwork><![CDATA[
    LINK /articles/1 HTTP/1.1
    Host: example.org
    Link: <articles/2>; rel="mentionedBy"
      ]]></artwork></figure>
 
    </section>
    
  </back>
  
</rfc>