idnits 2.17.1 draft-snell-more-link-relations-00.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack a both a reference to RFC 2119 and the recommended RFC 2119 boilerplate, even if it appears to use RFC 2119 keywords. RFC 2119 keyword, line 86: '... Specific String (NSS) MUST be one of:...' Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year -- The document date (August 29, 2013) is 3891 days in the past. Is this intentional? Checking references for intended status: Informational ---------------------------------------------------------------------------- -- Obsolete informational reference (is this intentional?): RFC 5988 (Obsoleted by RFC 8288) Summary: 1 error (**), 0 flaws (~~), 1 warning (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Network Working Group J. Snell 3 Internet-Draft 4 Intended status: Informational August 29, 2013 5 Expires: March 02, 2014 7 Additional Link Relations and the urn:social Namespace 8 draft-snell-more-link-relations-00 10 Abstract 12 This specification defines a number of additional Link Relation Types 13 that can used for a variety of purposes.. 15 Status of This Memo 17 This Internet-Draft is submitted to IETF in full conformance with the 18 provisions of BCP 78 and BCP 79. 20 Internet-Drafts are working documents of the Internet Engineering 21 Task Force (IETF). Note that other groups may also distribute 22 working documents as Internet-Drafts. The list of current Internet- 23 Drafts is at http://datatracker.ietf.org/drafts/current/. 25 Internet-Drafts are draft documents valid for a maximum of six months 26 and may be updated, replaced, or obsoleted by other documents at any 27 time. It is inappropriate to use Internet-Drafts as reference 28 material or to cite them other than as "work in progress." 30 This Internet-Draft will expire on March 02, 2014. 32 Copyright Notice 34 Copyright (c) 2013 IETF Trust and the persons identified as the 35 document authors. All rights reserved. 37 This document is subject to BCP 78 and the IETF Trust's Legal 38 Provisions Relating to IETF Documents 39 (http://trustee.ietf.org/license-info) in effect on the date of 40 publication of this document. Please review these documents 41 carefully, as they describe your rights and restrictions with respect 42 to this document. 44 Table of Contents 46 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 47 2. The 'social' URN Namespace . . . . . . . . . . . . . . . . . 2 48 2.1. urn:social:everyone . . . . . . . . . . . . . . . . . . . 3 49 2.2. urn:social:direct . . . . . . . . . . . . . . . . . . . . 3 50 2.3. urn:social:extended . . . . . . . . . . . . . . . . . . . 3 51 2.4. urn:social:peer . . . . . . . . . . . . . . . . . . . . . 3 52 2.5. urn:social:subordinate . . . . . . . . . . . . . . . . . 4 53 2.6. urn:social:superior . . . . . . . . . . . . . . . . . . . 4 54 2.7. urn:social:common . . . . . . . . . . . . . . . . . . . . 4 55 2.8. urn:social:interested . . . . . . . . . . . . . . . . . . 5 56 2.9. urn:social:self . . . . . . . . . . . . . . . . . . . . . 5 57 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5 58 4. Security Considerations . . . . . . . . . . . . . . . . . . . 6 59 5. Informative References . . . . . . . . . . . . . . . . . . . 6 60 Appendix A. Examples . . . . . . . . . . . . . . . . . . . . . . 6 61 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 7 63 1. Introduction 65 This specification defines and adds the following additional link 66 relation types to the IANA Registry of Link Relations established by 67 [RFC5988]: to, bto, cc, bcc, from, bfrom, source, generator, 68 provider, location, alias and mentionedBy. Further, this 69 specification proposes a new 'social' URN namespace. 71 Note that this document is a work-in-progress draft specification 72 that does not yet represent a "standard". It is the intention of 73 this specification to propose a few new ideas and openly solicit 74 feedback on their definition and use. While this document might 75 eventually evolve into an RFC the ideas described herein have not yet 76 been broadly implemented and have definitions that may evolve through 77 successive iterations of this draft. 79 2. The 'social' URN Namespace 81 This specification defines the 'social' URN namespace having the 82 following structure: 84 urn:social:{NSS} 86 The Namespace Specific String (NSS) MUST be one of: 88 o everyone 90 o direct 91 o extended 93 o peer 95 o subordinate 97 o superior 99 o common 101 o interested 103 o self 105 Within any given social networking system, there is an available 106 population of entities. Each NSS term represent specific subsets of 107 this population and are defined in terms of these subsets relative to 108 a fixed context. For example, if the fixed content is a person, the 109 "urn:social:direct" URN identifies the subset of the total population 110 that is directly connected to the context person within the social 111 graph, while the "urn:social:extended" URN identifies the subset that 112 is directly or indirectly connected to the context person. 114 The 'social' URN namespace is defined to be intentionally ambiguous 115 and contextually dependent. The specific interpretation of each NSS 116 depends entirely on how and where the NSS is being used. 118 2.1. urn:social:everyone 120 The "urn:social:everyone" URN identifies the subset of the total 121 population that is visible to the context. 123 2.2. urn:social:direct 125 The "urn:social:direct" URN identifies the subset of the total 126 population that is both visible to and directly connection to the 127 context. 129 2.3. urn:social:extended 131 The "urn:social:extended" URN identifies the subset of the total 132 population that is visible to and connected either directly or 133 indirectly to the context. 135 2.4. urn:social:peer 136 The "urn:social:peer" URN identifies the subset of the total 137 population that is both visible to the context and considered to be a 138 "peer". 140 Peer relationships exist only within social networking populations in 141 which there exist hierarchical divisions and relationships between 142 members of the population. An example of such a network would be a 143 company or similarly structured organization. Peers may or may not 144 be directly or indirectly connected to the target resource but are 145 considered, instead, to share the same hierarchical position within 146 the social network. 148 2.5. urn:social:subordinate 150 The "urn:social:subordinate" URN identifies the subset of the total 151 population that is both visible to the context and considered to be 152 "subordinate" to the context. 154 Subordinate relationships exist only within social networking 155 populations in which there exist hierarchical divisions and 156 relationships between members of the population. An example of such 157 a network would be a company or similarly structured organization. 158 Subordinates may or may not be directly or indirectly connected to 159 the target resource but are considered, instead, to share a lower 160 hierarchical position within the social network. 162 2.6. urn:social:superior 164 The "urn:social:superior" URN identifies the subset of the total 165 population that is both visible to the context and considered to be 166 "superior" to the context. 168 Superior relationships exist only within social networking 169 populations in which there exist hierarchical divisions and 170 relationships between members of the population. An example of such 171 a network would be a company or similarly structured organization. 172 Superiors may or may not be directly or indirectly connected to the 173 target resource but are considered, instead, to share a higher 174 hierarchical position within the social network. 176 2.7. urn:social:common 178 The "urn:social:common" URN identifies the subset of the total 179 population that is both visible to the context and is determined to 180 share the same common interests as the context. 182 Determination of "shared interest" is dependent entirely on the 183 application. 185 2.8. urn:social:interested 187 The "urn:social:interested" URN identifies the subset of the total 188 population that is both visible to the context and has an express 189 interest in the context. Examples of members of the "interested" 190 subset are those who have elected to "follow" the activity of the 191 context resource. 193 2.9. urn:social:self 195 The "urn:social:self" URN identifies the context resource itself as a 196 member of the total population. 198 3. IANA Considerations 200 The following Link Relations are added to the IANA Registry of Link 201 Relations. 203 +---------------+---------------------------------------------------+ 204 | Name | Description | 205 +---------------+---------------------------------------------------+ 206 | to | Refers to a resource that is considered to be | 207 | | part of the public primary audience of the link's | 208 | | context. | 209 | bto | Refers to a resource that is considered to be | 210 | | part of the private primary audience of the | 211 | | link's context. | 212 | cc | Refers to a resource that is considered to be | 213 | | part of the public secondary audience of the | 214 | | link's context. | 215 | bcc | Refers to a resource that is considered to be | 216 | | part of the private secondary audience of the | 217 | | link's context. | 218 | from | Refers to a resource that is publicly considered | 219 | | to be the originator of the link's context. | 220 | bfrom | Refers to a resource that is privately considered | 221 | | to be the orignator of the link's context. | 222 | source | Refers to the original source of information | 223 | | contained by the context resource. | 224 | provider | Refers to the resource that provided the context | 225 | | resource. Typically, this would be used to | 226 | | identify the entity publishing the resource. | 227 | generator | Refers to the resource that generated the context | 228 | | resource. Typically, this would be used to | 229 | | identify the software application that created | 230 | | the context resource. | 231 | mentionedBy | Refers to a resource that mentions the context | 232 | | resource in some fashion. This, for example, | 233 | | would be used when an article mentions another | 234 | | article, or a social status update mentions a | 235 | | particular user, etc. | 236 | location | References a URI/IRI that represents a physical | 237 | | or logical location with which the context | 238 | | resource is associated. | 239 +---------------+---------------------------------------------------+ 241 4. Security Considerations 243 There are no additional security concerns introduced by this 244 document. 246 5. Informative References 248 [RFC5988] Nottingham, M., "Web Linking", RFC 5988, October 2010. 250 Appendix A. Examples 252 Using targeting link relations and the urn:social namespace: 254 POST /alerts HTTP/1.1 255 Host: example.org 256 Content-Type: text/plain 257 Authorization: Basic {Base64 Credentials} 258 Link: ; rel="to" 259 Link: ; rel="cc" 260 Link: ; rel="bfrom" 262 Test message 264 Using publication link relations: 266 267 268 ... 269 272 275 278 ... 279 280 ... 281 283 Using the alias and location relations: 285 Link: ; rel="location" 287 Using the mentionedBy relation: 289 LINK /articles/1 HTTP/1.1 290 Host: example.org 291 Link: ; rel="mentionedBy" 293 Author's Address 295 James M Snell 297 Email: jasnell@gmail.com