ldp.html
author sspeiche
Mon, 16 Jun 2014 13:16:10 -0400
changeset 657 ee78ccdc54ec
parent 655 4127dd3a8fea
child 659 775deb8e635f
permissions -rw-r--r--
Updated status of this doc for CR
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
     1
<!DOCTYPE html>
194
b6d66196a02d Fixed biblirefs, consistency items and moved editor todo into comments
sspeiche
parents: 192
diff changeset
     2
<!-- 
480
96f2d9c4a742 Updated LDPC DELETE language and cleanup todos
sspeiche
parents: 479
diff changeset
     3
	TODO: Search for them within this document.
96f2d9c4a742 Updated LDPC DELETE language and cleanup todos
sspeiche
parents: 479
diff changeset
     4
	TODO: Once companion documents (best practices, primer) have URLs, link to them.  Search on "companion".
495
559a77692da5 Fixed up some specref references
sspeiche
parents: 494
diff changeset
     5
	TODO: Add new "discovery of server capabilities" non-norm section
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
     6
    TODO: Consider adding Venn diagram for differences of LDPCs
194
b6d66196a02d Fixed biblirefs, consistency items and moved editor todo into comments
sspeiche
parents: 192
diff changeset
     7
 -->
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
     8
<html>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
     9
  <head>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    10
    <title>Linked Data Platform 1.0</title>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    11
    <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    12
    <!-- 
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    13
      === NOTA BENE ===
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    14
      For the three scripts below, if your spec resides on dev.w3 you can check them
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    15
      out in the same tree and use relative links so that they'll work offline,
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    16
     -->
443
02e1a65a8776 Set maxTocLevel=2 properly with fix from respec
sspeiche
parents: 439
diff changeset
    17
    <script src='https://www.w3.org/Tools/respec/respec-w3c-common' class='remove' async></script> 
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    18
    <script class='remove'>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    19
      var respecConfig = {
522
b3fd53a7b048 Prepare for LC2
sspeiche
parents: 521
diff changeset
    20
          // specification status (e.g. ED, WD, LC, NOTE, etc.). If in doubt use ED.
655
4127dd3a8fea CR prep, gettings test suite URIs aligned
sspeiche
parents: 653
diff changeset
    21
          specStatus:           "CR",
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    22
          
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    23
          // the specification's short name, as in http://www.w3.org/TR/short-name/
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    24
          shortName:            "ldp",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    25
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    26
          // if your specification has a subtitle that goes below the main
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    27
          // formal title, define it here
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    28
          // subtitle   :  "an excellent document",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    29
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    30
          // if you wish the publication date to be other than today, set this
539
8ff6773d4daa Set publication status and history for post 2nd LC edits
sspeiche
parents: 527
diff changeset
    31
          //publishDate:  "2014-03-11",
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    32
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    33
          // if the specification's copyright date is a range of years, specify
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    34
          // the start date here:
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    35
          // copyrightStart: "2005"
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    36
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    37
          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    38
          // and its maturity status
539
8ff6773d4daa Set publication status and history for post 2nd LC edits
sspeiche
parents: 527
diff changeset
    39
          previousPublishDate:  "2014-03-11",
274
8db905ebe0ba Basic preparation for edits unto LC draft
sspeiche
parents: 238
diff changeset
    40
          previousMaturity:  	"LC",
539
8ff6773d4daa Set publication status and history for post 2nd LC edits
sspeiche
parents: 527
diff changeset
    41
          previousURI: 			"http://www.w3.org/TR/2014/WD-ldp-20140311/",
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    42
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    43
          // if there a publicly available Editor's Draft, this is the link
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    44
          edDraftURI:           "http://www.w3.org/2012/ldp/hg/ldp.html",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    45
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    46
          // if this is a LCWD, uncomment and set the end of its review period
655
4127dd3a8fea CR prep, gettings test suite URIs aligned
sspeiche
parents: 653
diff changeset
    47
          //lcEnd: "2014-04-02",
4127dd3a8fea CR prep, gettings test suite URIs aligned
sspeiche
parents: 653
diff changeset
    48
          crEnd: "2014-07-17",
4127dd3a8fea CR prep, gettings test suite URIs aligned
sspeiche
parents: 653
diff changeset
    49
          
4127dd3a8fea CR prep, gettings test suite URIs aligned
sspeiche
parents: 653
diff changeset
    50
          testSuiteURI: "https://dvcs.w3.org/hg/ldpwg/raw-file/tip/tests/ldp-testsuite.html",
4127dd3a8fea CR prep, gettings test suite URIs aligned
sspeiche
parents: 653
diff changeset
    51
          implementationReportURI: "https://dvcs.w3.org/hg/ldpwg/raw-file/tip/tests/reports/ldp.html",
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
    52
          
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
    53
          // Only include h1 and h2 level
443
02e1a65a8776 Set maxTocLevel=2 properly with fix from respec
sspeiche
parents: 439
diff changeset
    54
          maxTocLevel: 2,
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    55
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    56
          // if you want to have extra CSS, append them to this list
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    57
          // it is recommended that the respec.css stylesheet be kept
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    58
          //extraCSS:             ["https://dvcs.w3.org/hg/ldpwg/css/respec.css"],
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    59
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    60
          // editors, add as many as you like
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    61
          // only "name" is required
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    62
          editors:  [
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    63
              { name: "Steve Speicher", url: "http://stevespeicher.blogspot.com",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    64
                company: "IBM Corporation", companyURL: "http://ibm.com/" },
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
    65
              { name: "John Arwe", url: "https://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/allcommunities?userid=120000CAW7",
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
    66
                company: "IBM Corporation", companyURL: "http://ibm.com/" },
237
6871b9ac5339 Fixed various link checker bugs
sspeiche
parents: 235
diff changeset
    67
			  {name: "Ashok Malhotra", url: "mailto:ashok.malhotra@oracle.com",
99
Ashok Malhotra <Ashok.Malhotra@Oracle.com>
parents: 98
diff changeset
    68
			    company: "Oracle Corporation", companyURL: "http://www.oracle.com" },
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    69
          ],
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    70
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    71
          // authors, add as many as you like. 
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    72
          // This is optional, uncomment if you have authors as well as editors.
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    73
          // only "name" is required. Same format as editors.
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    74
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    75
          //authors:  [
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    76
          //    { name: "Your Name", url: "http://example.org/",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    77
          //      company: "Your Company", companyURL: "http://example.com/" },
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    78
          //],
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    79
          
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    80
          // name of the WG
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    81
          wg:           "Linked Data Platform Working Group",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    82
          
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    83
          // URI of the public WG page
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    84
          wgURI:        "http://www.w3.org/2012/ldp",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    85
          
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    86
          // name (without the @w3c.org) of the public mailing to which comments are due
234
992015a0d3cd Setting all LC status items for prep for publication
sspeiche
parents: 233
diff changeset
    87
          wgPublicList: "public-ldp-comments",
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    88
          
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    89
          // URI of the patent status for this WG, for Rec-track documents
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    90
          // !!!! IMPORTANT !!!!
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    91
          // This is important for Rec-track documents, do not copy a patent URI from a random
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    92
          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    93
          // Team Contact.
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    94
          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/55082/status",
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
    95
          doRDFa: "1.1",
386
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
    96
			localBiblio:  {
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
    97
				"RFC7230": {
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
    98
					title:    "Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
    99
				,   href:     "http://tools.ietf.org/html/rfc7230"
386
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   100
				,   authors:  [
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   101
						"R. Fielding"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   102
					,   "J. Reschke"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   103
					]
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   104
				,   status:   "Proposed Standard"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   105
				,   publisher:  "IETF"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   106
				},
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   107
				"RFC7231": {
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   108
					title:    "Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   109
				,   href:     "http://tools.ietf.org/html/rfc7231"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   110
				,   authors:  [
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   111
						"R. Fielding"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   112
					,   "J. Reschke"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   113
					]
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   114
				,   status:   "Proposed Standard"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   115
				,   publisher:  "IETF"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   116
				},
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   117
				"RFC7232": {
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   118
					title:    "Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   119
				,   href:     "http://tools.ietf.org/html/rfc7232"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   120
				,   authors:  [
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   121
						"R. Fielding"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   122
					,   "J. Reschke"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   123
					]
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   124
				,   status:   "Proposed Standard"
386
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   125
				,   publisher:  "IETF"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   126
				},
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   127
				"RFC2817": {
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   128
					title:    "Upgrading to TLS Within HTTP/1.1"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   129
				,   href:     "http://tools.ietf.org/html/rfc2817"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   130
				,   authors:  [
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   131
						"R. Khare"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   132
					,   "S. Lawrence"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   133
					]
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   134
				,   status:   "Proposed Standard"
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   135
				,   publisher:  "IETF"
412
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   136
				},
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   137
				"RFC5005": {
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   138
					title:    "Feed Paging and Archiving"
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   139
				,   href:     "http://tools.ietf.org/html/rfc5005"
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   140
				,   authors:  [
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   141
						"M. Nottingham"
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   142
					]
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   143
				,   status:   "Proposed Standard"
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   144
				,   publisher:  "IETF"
497
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   145
				},
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   146
				"LDP-PAGING": {
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   147
					title:    "Linked Data Platform Paging"
525
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   148
				,   href:     "https://dvcs.w3.org/hg/ldpwg/raw-file/default/ldp-paging.html"
497
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   149
				,   authors:  [
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   150
						"S. Speicher", "J. Arwe", "A. Malhotra"
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   151
					]
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   152
				,   status:   "Editor's Working Draft"
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   153
				,   publisher:  "W3C"
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   154
				},
550
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   155
				"POWDER": {
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   156
					title:    "Protocol for Web Description Resources (POWDER): Description Resources"
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   157
				,   href:     "http://www.w3.org/TR/2009/REC-powder-dr-20090901/"
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   158
				,   authors:  [
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   159
						"Phil Archer", "Kevin Smith", "Andrea Perego"
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   160
					]
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   161
				,   status:   "W3C Recommendation"
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   162
				,   publisher:  "W3C"
58d6a84e5f10 add in powder's describedby content
John Arwe
parents: 549
diff changeset
   163
				},
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   164
				"RFC7240": {
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   165
					title:    "Prefer Header for HTTP"
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   166
				,   href:     "http://tools.ietf.org/html/rfc7240"
516
b46f235b5fcc Fixed biblio and dfn references
sspeiche
parents: 515
diff changeset
   167
				,   authors:  [
b46f235b5fcc Fixed biblio and dfn references
sspeiche
parents: 515
diff changeset
   168
						"J. Snell"
b46f235b5fcc Fixed biblio and dfn references
sspeiche
parents: 515
diff changeset
   169
					]
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   170
				,   status:   "Proposed Standard"
516
b46f235b5fcc Fixed biblio and dfn references
sspeiche
parents: 515
diff changeset
   171
				,   publisher:  "IETF"
b46f235b5fcc Fixed biblio and dfn references
sspeiche
parents: 515
diff changeset
   172
				},
634
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   173
				"Accept-Post": {
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   174
					title:    "The Accept-Post HTTP Header"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   175
				,   href:     "http:tools.ietf.org/html/draft-wilde-accept-post"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   176
				,   authors:  [
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   177
						"J. Arwe", "S. Speicher", "E. Wilde"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   178
					]
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   179
				,   status:   "Internet Draft"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   180
				,   publisher:  "IETF"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   181
				},
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   182
				"LDP-Tests": {
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   183
					title:    "Linked Data Platform 1.0 Test Cases"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   184
				,   href:     "https://dvcs.w3.org/hg/ldpwg/raw-file/tip/Test%20Cases/LDP%20Test%20Cases.html"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   185
				,   authors:  [
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   186
						"R. Garcia-Castro", "F. Serena"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   187
					]
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   188
				,   status:   "Editor's Draft of Working Group Note"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   189
				,   publisher:  "W3C"
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   190
				},
386
b7c514f96add Resolve ACTION-108 move restatements of HTTP et al. out of normative sections
John Arwe
parents: 385
diff changeset
   191
			},
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   192
      };
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   193
    </script>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   194
    <style type="text/css">
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   195
    	div.rule {padding-top: 1em;}
124
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   196
    	div.ldp-issue-open {
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   197
	    	border-color: #E05252;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   198
			background: #FBE9E9;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   199
			padding: 0.5em;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   200
			margin: 1em 0;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   201
			position: relative;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   202
			clear: both;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   203
			border-left-width: .5em;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   204
			border-left-style: solid;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   205
    	}
124
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   206
    	div.ldp-issue-pending {
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   207
	    	border-color: #FAF602;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   208
			background: #F7F6BC;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   209
			padding: 0.5em;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   210
			margin: 1em 0;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   211
			position: relative;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   212
			clear: both;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   213
			border-left-width: .5em;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   214
			border-left-style: solid;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   215
    	}
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   216
    	div.ldp-issue-closed {
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   217
	    	border-color: #009900;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   218
			background: #BCF7CF;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   219
			padding: 0.5em;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   220
			margin: 1em 0;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   221
			position: relative;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   222
			clear: both;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   223
			border-left-width: .5em;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   224
			border-left-style: solid;
6f1d7304f03f create different styles to differentiate issues based on their status: open, pending, closed
Arnaud Le Hors <lehors@us.ibm.com>
parents: 122
diff changeset
   225
    	}
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   226
    	div.ldp-issue-title {
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   227
    	    color: #E05252;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   228
    	    padding-right: 1em;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   229
            min-width: 7.5em;
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   230
    	}
184
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   231
		.atrisk {
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   232
			padding:    1em;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   233
			margin: 1em 0em 0em;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   234
			border: 1px solid #f00;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   235
			background: #ffc;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   236
		}
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   237
		.atrisktext {
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   238
			/* content:    "Feature At Risk"; */
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   239
			display:    block;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   240
			width:  150px;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   241
			margin: -1.5em 0 0.5em 0;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   242
			font-weight:    bold;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   243
			border: 1px solid #f00;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   244
			background: #fff;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   245
			padding:    3px 1em;
30f00f94855a copy at-risk markup from turtle spec
John Arwe
parents: 183
diff changeset
   246
		}
437
631936d65086 Fixed formating with >h2 formatting
sspeiche
parents: 436
diff changeset
   247
		.normal { 
631936d65086 Fixed formating with >h2 formatting
sspeiche
parents: 436
diff changeset
   248
			font-weight: normal;
631936d65086 Fixed formating with >h2 formatting
sspeiche
parents: 436
diff changeset
   249
			font: normal 100% sans-serif;
631936d65086 Fixed formating with >h2 formatting
sspeiche
parents: 436
diff changeset
   250
		}
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   251
		.indented { 
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   252
			margin-left: +3em;
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   253
		}
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   254
		tr:nth-of-type(odd),.oddrow { 
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   255
			background:#F2F2F2; /* light grey, just enough to differentiate from white */
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   256
		}
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   257
		td { 
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   258
			padding:0 +1ex 0 +1ex; /* add a bit of space from rule/edge to text */
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   259
		}
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   260
		
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   261
    </style>
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   262
    <style type="text/css" media="all">
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   263
    	code {
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   264
    	    font-weight:bold;
120
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   265
			font-size:larger;
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   266
    	}
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   267
		 /* ReSpec uses color ff4500 for code elements, which does not print well on some black & white printers
120
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   268
		    and is a little hard to read for some folks even on-line. 
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   269
			The default code font size was also somewhat too small/hard to read.
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   270
		*/
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   271
    </style>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   272
  </head>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   273
<body>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   274
<section id='abstract'>
215
da72115eb40b Various updates per review of Raul
sspeiche
parents: 213
diff changeset
   275
This document describes a set of best practices and simple approach for a read-write Linked Data architecture, based on
78
539b6b098ee8 Comments received from David Woods: abstract, paging informative (part 1)
sspeiche
parents: 77
diff changeset
   276
HTTP access to web resources that describe their state using the <abbr title="Resource Description Framework">RDF</abbr>
539b6b098ee8 Comments received from David Woods: abstract, paging informative (part 1)
sspeiche
parents: 77
diff changeset
   277
data model.
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   278
</section>
525
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   279
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   280
 <section id='sotd'>
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   281
   <p>
657
ee78ccdc54ec Updated status of this doc for CR
sspeiche
parents: 655
diff changeset
   282
   	 This is the Candidate Recommendation document where the Working Group has addressed all
ee78ccdc54ec Updated status of this doc for CR
sspeiche
parents: 655
diff changeset
   283
   	 raised issues and seeks to gather implementation feedback.  For changes since last publication, see <a href="#history" class="sectionRef"></a>. 
634
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   284
	 A test suite is available at [[LDP-Tests]].
525
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   285
   </p>
634
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   286
   <p>The following features are At Risk:</p>
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   287
   <ol>
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   288
   <li>The <a href="#header-accept-post">HTTP Accept-Post header</a>, 
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   289
		that allows clients to determine which media types a server accepts on POST requests.
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   290
	</li>
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   291
   <li>The requirement that LDP clients be <a href="#atrisk-paging">paging-aware</a>.
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   292
	</li>
1aaf16a1b67e address comments from CR transition call
John Arwe
parents: 601
diff changeset
   293
   </ol>
525
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   294
 </section>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   295
 
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   296
<section class="informative" id="intro">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   297
<h1>Introduction</h1>
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   298
	<p>This specification describes the use
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   299
	of HTTP for accessing, updating, creating and deleting resources from
486
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
   300
	servers that expose their resources as Linked Data.  It provides clarifications
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   301
	and extensions of the rules of Linked Data [[LINKED-DATA]]:</p>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   302
	<ol>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   303
		<li>Use URIs as names for things</li>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   304
		<li>Use HTTP URIs so that people can look up those names</li>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   305
		<li>When someone looks up a URI, provide useful information, using the standards
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   306
			(RDF*, <abbr title="SPARQL Protocol and RDF Query Language">SPARQL</abbr>)
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   307
		</li>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   308
		<li>Include links to other URIs, so that they can discover more things</li>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   309
	</ol>
415
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
   310
	<p>This specification discusses standard HTTP and RDF techniques  
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
   311
	used when constructing clients and servers that 
395
0408e1e5bbf8 ACTION-105: Update spec to reflect 9/30 resolution moving Paging links to HTTP headers (partial: does not include sort criteria changes yet)
John Arwe
parents: 393
diff changeset
   312
	create, read, and write <a title="Linked Data Platform Resource">Linked Data Platform Resources</a>.
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   313
	A companion document discusses best practices that you 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   314
	should use, and anti-patterns you should avoid, when constructing these clients and servers.
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   315
	</p> 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   316
	<p>This specification defines a special type of <a>Linked Data Platform Resource</a>: a 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   317
	<a title="Linked Data Platform Container">Container</a>.  Containers are very useful 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   318
	in building application models involving collections of resources, often homogeneous ones. 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   319
	For example, universities offer a collection of classes 
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   320
	and a collection of faculty members, each faculty member teaches a collection of courses, and so on. 
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   321
	This specification discusses how to work with containers.  Resources can be added to containers  
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   322
	using standard HTTP operations like 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   323
	POST (see <a href="#ldpc-HTTP_POST" class="sectionRef"></a>).</p>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   324
	<p>The intention of this specification is to enable additional rules and layered groupings of rules as 
204
04f24555e6aa Added wording re. model to Introduction
Ashok Malhotra <Ashok.Malhotra@Oracle.com>
parents: 202
diff changeset
   325
	additional specifications.  The scope is intentionally narrow to provide a set of key rules for 
04f24555e6aa Added wording re. model to Introduction
Ashok Malhotra <Ashok.Malhotra@Oracle.com>
parents: 202
diff changeset
   326
	reading and writing Linked Data that most, if not all, other specifications will depend upon and 
208
0cd38b1b5d41 Various editorial cleanups in intro
sspeiche
parents: 207
diff changeset
   327
	implementations will support.</p>
497
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   328
	<p>This specification provides some approaches to deal with large resources.  An extension to this specification
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   329
	provides the ability to break large resource representations into multiple paged responses [[LDP-PAGING]].</p>
439
28beff0a4f89 Updated reference to LDP BPG editor's draft and added ref to LDP-UCR
sspeiche
parents: 438
diff changeset
   330
	<p>For context and background, it could be useful to read <a href="#bib-LDP-UCR">Linked Data Platform Use Case and Requirements</a> [[LDP-UCR]] 
28beff0a4f89 Updated reference to LDP BPG editor's draft and added ref to LDP-UCR
sspeiche
parents: 438
diff changeset
   331
	and <a href="#base-specs" class="sectionRef"></a>.</p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   332
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   333
	
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   334
<section id="terms">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   335
<h1>Terminology</h1>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   336
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   337
<p>Terminology is based on W3C's Architecture of the World Wide Web [[!WEBARCH]] and 
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   338
	Hyper-text Transfer Protocol ([[!RFC7230]], [[!RFC7231]], [[!RFC7232]]).
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   339
</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   340
  <dl class="glossary">
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   341
	<dt>Link</dt>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   342
	<dd>A relationship between two resources when one resource (representation) refers to the other resource by means
496
94420c5678ae Reference cleanup and tweak LDP-RS term
sspeiche
parents: 495
diff changeset
   343
		of a URI [[WEBARCH]].
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   344
		<p></p></dd>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   345
							
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   346
	<dt>Linked Data</dt>
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   347
	<dd>As defined by Tim Berners-Lee [[LINKED-DATA]].<p></p></dd>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   348
	
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   349
	<dt>Client</dt>
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   350
	<dd>A program that establishes connections for the purpose of sending one or more HTTP requests [[!RFC7230]].<p></p></dd>
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   351
	
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   352
	<dt>Server</dt>
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   353
	<dd>A program that accepts connections in order to service HTTP requests by sending HTTP responses. 
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   354
		<p>
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   355
		The terms "client" and "server" refer only to the roles that these programs perform for a particular connection.  
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   356
		The same program might act as a client on some connections and a server on others.
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   357
		</p>
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   358
		<p>
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   359
		HTTP enables the use of intermediaries to satisfy requests through a
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   360
		chain of connections.  There are three common forms of HTTP
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   361
		intermediary: proxy, gateway, and tunnel.  In some cases, a single
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   362
		intermediary might act as an origin server, proxy, gateway, or
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   363
		tunnel, switching behavior based on the nature of each request.
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   364
		[[!RFC7230]]. 
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   365
		</p>
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   366
	</dd>
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   367
	
331
2e0bbaef0442 fixed a few minor respec errors
sspeiche
parents: 325
diff changeset
   368
	<dt><dfn>Linked Data Platform Resource</dfn> (<abbr title="Linked Data Platform Resource">LDPR</abbr>)</dt>
461
64c0ca32c9e6 Cleanup from Action-123 add LDPR-RR and LDPR-BR
John Arwe
parents: 460
diff changeset
   369
	<dd>A HTTP resource whose state is represented in any way that conforms to the simple lifecycle
215
da72115eb40b Various updates per review of Raul
sspeiche
parents: 213
diff changeset
   370
		patterns and conventions in <a href="#ldpr" class="sectionRef"></a>.<p></p></dd>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   371
		
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   372
	<dt><dfn>Linked Data Platform RDF Source</dfn> (<abbr title="Linked Data Platform RDF Source">LDP-RS</abbr>)</dt>
496
94420c5678ae Reference cleanup and tweak LDP-RS term
sspeiche
parents: 495
diff changeset
   373
	<dd>An <a title="Linked Data Platform Resource">LDPR</a> whose state is fully represented in RDF, corresponding to
549
084cb71ce842 removal of named graphs, per today's WG resolution
John Arwe
parents: 548
diff changeset
   374
	an RDF graph. See also the term
495
559a77692da5 Fixed up some specref references
sspeiche
parents: 494
diff changeset
   375
	<a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-source">RDF Source</a> from [[!rdf11-concepts]].
448
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   376
	<p></p></dd>	
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   377
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   378
	<dt><dfn>Linked Data Platform Non-RDF Source</dfn> (<abbr title="Linked Data Platform Non-RDF Source">LDP-NR</abbr>)</dt>
514
7e329a35960e A vs an fun
sspeiche
parents: 513
diff changeset
   379
	<dd>An <a title="Linked Data Platform Resource">LDPR</a> whose state is <em>not</em> represented in RDF.
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   380
	For example, these can be binary or text documents that do not have useful RDF representations.
448
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   381
	<p></p></dd>
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   382
		
331
2e0bbaef0442 fixed a few minor respec errors
sspeiche
parents: 325
diff changeset
   383
	<dt><dfn>Linked Data Platform Container</dfn> (<abbr title="Linked Data Platform Container">LDPC</abbr>)</dt>
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   384
	<dd>A LDP-RS representing a collection of linked
496
94420c5678ae Reference cleanup and tweak LDP-RS term
sspeiche
parents: 495
diff changeset
   385
	documents (<a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-document">RDF Document</a> [[!rdf11-concepts]] or information resources [[!WEBARCH]])
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   386
	that responds to client requests for creation, modification, and/or enumeration of its linked members and documents, 
461
64c0ca32c9e6 Cleanup from Action-123 add LDPR-RR and LDPR-BR
John Arwe
parents: 460
diff changeset
   387
	and that conforms to the simple lifecycle
64c0ca32c9e6 Cleanup from Action-123 add LDPR-RR and LDPR-BR
John Arwe
parents: 460
diff changeset
   388
	patterns and conventions in <a href="#ldpc" class="sectionRef"></a>.
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   389
	<p></p></dd>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   390
	
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   391
	<dt><dfn>Linked Data Platform Basic Container</dfn> (<abbr title="Linked Data Platform Basic Container">LDP-BC</abbr>)</dt>
514
7e329a35960e A vs an fun
sspeiche
parents: 513
diff changeset
   392
	<dd>An <a title="Linked Data Platform Container">LDPC</a> that defines a simple link to
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   393
	its <a title="Containment">contained</a> documents (information resources) [[!WEBARCH]].
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   394
	<p></p></dd>
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   395
	
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   396
	<dt><dfn>Linked Data Platform Direct Container</dfn> (<abbr title="Linked Data Platform Direct Container">LDP-DC</abbr>)</dt>
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   397
	<dd>An <a title="Linked Data Platform Container">LDPC</a> that adds the concept of <a title="Membership">membership</a>, allowing the flexibility of choosing what form its 
461
64c0ca32c9e6 Cleanup from Action-123 add LDPR-RR and LDPR-BR
John Arwe
parents: 460
diff changeset
   398
	<a title="Membership triples">membership triples</a> take, and allows <a title="Membership">members</a> to be 
496
94420c5678ae Reference cleanup and tweak LDP-RS term
sspeiche
parents: 495
diff changeset
   399
	any resources [[!WEBARCH]], not only documents.
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   400
	<p></p></dd>
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   401
	
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   402
	<dt><dfn>Linked Data Platform Indirect Container</dfn> (<abbr title="Linked Data Platform Indirect Container">LDP-IC</abbr>)</dt>
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   403
	<dd>An <a title="Linked Data Platform Container">LDPC</a> similar to a <a title="Linked Data Platform Direct Container">LDP-DC</a>
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   404
	that is also capable of having <a title="Membership">members</a> whose URIs are based
461
64c0ca32c9e6 Cleanup from Action-123 add LDPR-RR and LDPR-BR
John Arwe
parents: 460
diff changeset
   405
	on the content of its <a title="Containment">contained</a> documents rather than the URIs assigned to those documents.
451
f68e4a59fba1 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 450
diff changeset
   406
	<p></p></dd>
491
16d872a712b6 Adopted container hierarchy and merged Indirect Container into Container
sspeiche
parents: 489
diff changeset
   407
		 
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   408
	<dt><dfn>Membership</dfn></dt>
601
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   409
	<dd>The relationship linking an LDPC and its member LDPRs, 
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   410
	which can be different resources than its <a title="Containment">contained</a> documents.  
601
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   411
	The LDPC often assists with managing the membership triples, whether or not the LDPC's
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   412
	URI occurs in them.
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   413
	<p></p></dd>
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
   414
120
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   415
	<dt><dfn>Membership triples</dfn></dt>
601
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   416
	<dd>A set of triples that lists an LDPC's members.
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   417
		A LDPC's membership triples all have one of the following patterns:
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   418
		<table class="indented">
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   419
		<tr>
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   420
		<td style="background:#DDDDDD"> <var>membership-constant-URI</var> </td>
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   421
		<td style="background:#FFFFFF"> <var>membership-predicate</var> </td>
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   422
		<td style="background:#CCFFFF"> <var>member-derived-URI</var> </td>
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   423
		</tr>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   424
		<tr>
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   425
		<td style="background:#CCFFFF"> <var>member-derived-URI</var> </td>
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   426
		<td style="background:#FFFFFF"> <var>membership-predicate</var> </td>
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   427
		<td style="background:#DDDDDD"> <var>membership-constant-URI</var> </td>
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   428
		</tr>
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   429
		</table>
415
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
   430
		The difference between the two is simply which position member-derived-URI occupies, which is usually
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   431
		driven by the choice of <var>membership-predicate</var>.  Most predicates have a natural forward direction
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   432
		inherent in their name, and existing vocabularies contain useful examples that read naturally in
453
a70c321daf12 ACTION-120 (Part 3) Added ldp:member
sspeiche
parents: 452
diff changeset
   433
		each direction.  <code>ldp:member</code> and <code>dcterms:isPartOf</code> are representative examples.
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   434
		<p>
503
d13ec755f468 Adjusted term membership triples and membership predicate
sspeiche
parents: 502
diff changeset
   435
		Each linked container exposes properties (see <a href="#ldpc-general" class="sectionRef"></a>)
415
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
   436
		that allow clients to determine which pattern it
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   437
		uses, what the actual <var>membership-predicate</var> and <var>membership-constant-URI</var> values are, 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   438
		and (for containers that allow the creation of new members) what value is used
415
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
   439
		for the <var>member-derived-URI</var> based on the client's input to the 
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   440
		creation process.</p>
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   441
	<p></p></dd>
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   442
	
120
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   443
	<dt><dfn>Membership predicate</dfn></dt>
601
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   444
	<dd>The predicate of all an LDPC's <a title="Membership triples">membership triples</a>.
120
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   445
	<p></p></dd>
edf269bcce8a Issue-64 change ?non-member-properties into Link header with extension relation type
John Arwe
parents: 116
diff changeset
   446
	
465
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   447
	<dt><dfn>Containment</dfn></dt>
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   448
	<dd>The relationship binding an LDPC to LDPRs whose lifecycle it controls and is aware of.  The
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   449
	lifecycle of the contained LDPR is limited by the lifecycle of the containing LDPC;
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   450
	that is, a contained LDPR cannot be created (through LDP-defined means) before its containing LDPC exists.
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   451
	<p></p></dd>
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   452
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   453
	<dt><dfn>Containment triples</dfn></dt>
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   454
	<dd>
561
ceeb37eb8f71 Clarify definitions of membership and containment triples to address Martin Nally comment
John Arwe
parents: 559
diff changeset
   455
	A set of triples, maintained by the LDPC, that lists documents created by the LDPC but not yet deleted.
465
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   456
	These triples <strong>always</strong> have the form: <var>( LDPC URI, ldp:contains , document-URI )</var>.
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   457
	<p></p></dd>
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
   458
554
5a4fe2b38a2a rename empty container triples to minimal container triples
John Arwe
parents: 553
diff changeset
   459
	<dt><dfn>Minimal-container triples</dfn></dt>
474
a074b88f9b68 ACTION-132: Use Prefer in place of non-member properties resource
John Arwe
parents: 473
diff changeset
   460
	<dd>
601
5fc4b4b9efc2 LDP: RS>LDPC in membership definitions; paging: incorporate todo list in prolog and fix respec messages
John Arwe
parents: 600
diff changeset
   461
	The portion of an LDPC's triples that would be present when the container is empty.  Currently, this definition
561
ceeb37eb8f71 Clarify definitions of membership and containment triples to address Martin Nally comment
John Arwe
parents: 559
diff changeset
   462
	is equivalent to all the LDPC's triples minus its containment triples, 
ceeb37eb8f71 Clarify definitions of membership and containment triples to address Martin Nally comment
John Arwe
parents: 559
diff changeset
   463
	and minus its membership triples (if either are considered part of its state), 
ceeb37eb8f71 Clarify definitions of membership and containment triples to address Martin Nally comment
John Arwe
parents: 559
diff changeset
   464
	but if future versions of LDP define additional classes of triples then this definition
474
a074b88f9b68 ACTION-132: Use Prefer in place of non-member properties resource
John Arwe
parents: 473
diff changeset
   465
	would expand to subtract out those classes as well.
412
b5f309858d98 Resolve ACTION-113 Update spec to reflect 11/04 resolution to remove 303 and have client use first/next links to detect paging
John Arwe
parents: 410
diff changeset
   466
	<p></p></dd>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   467
  </dl>
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   468
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   469
<section id="conventions">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   470
<h2>Conventions Used in This Document</h2>
512
28fb37e65361 Added namespace definition
sspeiche
parents: 511
diff changeset
   471
	<p>The namespace for LDP is <code>http://www.w3.org/ns/ldp#</code>.</p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   472
	<p>Sample resource representations are provided in <code>text/turtle</code>
495
559a77692da5 Fixed up some specref references
sspeiche
parents: 494
diff changeset
   473
		format [[turtle]].</p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   474
	<p>Commonly used namespace prefixes:</p>
93
598be81efe5f Expanded on wording for 4.3 to be more consistent
sspeiche
parents: 92
diff changeset
   475
	<pre style="word-wrap: break-word; white-space: pre-wrap;">	@prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
522
b3fd53a7b048 Prepare for LC2
sspeiche
parents: 521
diff changeset
   476
	@prefix foaf:    &lt;http://xmlns.com/foaf/0.1/&gt;.
486
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
   477
	@prefix rdf:     &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#&gt;.
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
   478
	@prefix ldp:     &lt;http://www.w3.org/ns/ldp#&gt;.
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
   479
	@prefix xsd:     &lt;http://www.w3.org/2001/XMLSchema#&gt;.</pre>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   480
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   481
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   482
    
71
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   483
<section id='conformance'>
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   484
72
73a5766e4794 ISSUE-29 - Use relative URIs in examples
sspeiche
parents: 71
diff changeset
   485
<p>The status of the sections of Linked Data Platform 1.0 (this document) is as follows:</p>
71
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   486
<ul>
463
ae72388dbb82 start action-127 paging use of [23]xx response code; also changed 'informative' to 'non-normative' so sandro is happy[ier]
John Arwe
parents: 462
diff changeset
   487
  <li>1. Introduction: <b>non-normative</b></li>
222
1db581afd1ec Added informative section 4.1 , therefore shifting all sections by one 4.1->4.2, etc
sspeiche
parents: 221
diff changeset
   488
  <li>2. Terminology: <b>normative</b></li>
71
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   489
  <li>3. Conformance: <b>normative</b></li>
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   490
  <li>4. Linked Data Platform Resources: <b>normative</b></li>
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   491
  <li>5. Linked Data Platform Containers: <b>normative</b></li>
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   492
  <li>6. Notable information from normative references: <b>non-normative</b></li>
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   493
  <li>7. HTTP Header Definitions: <b>normative</b></li>
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   494
  <li>8. Security Considerations: <b>non-normative</b></li>
463
ae72388dbb82 start action-127 paging use of [23]xx response code; also changed 'informative' to 'non-normative' so sandro is happy[ier]
John Arwe
parents: 462
diff changeset
   495
  <li>A. Acknowledgements: <b>non-normative</b></li> 
525
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   496
  <li>B. Change History: <b>non-normative</b></li>
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   497
  <li>C.1 Normative references: <b>normative</b></li>
238e04f1e4f1 LC prep, custom SOTD and history sections
sspeiche
parents: 522
diff changeset
   498
  <li>C.2 Non-normative references: <b>non-normative</b></li>
71
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   499
</ul>
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   500
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   501
<p>A conforming <b><dfn>LDP client</dfn></b> is a conforming HTTP client [[!RFC7230]] that follows the rules defined by LDP in
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   502
<a href="#ldpr" class="sectionRef"></a> and also
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   503
<a href="#ldpc" class="sectionRef"></a>.
372
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   504
</p>
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   505
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   506
<p>A conforming <b><dfn>LDP server</dfn></b> is a conforming HTTP server [[!RFC7230]] that follows the rules defined by LDP in 
372
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   507
<a href="#ldpr" class="sectionRef"></a> when it is serving LDPRs, and also
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   508
<a href="#ldpc" class="sectionRef"></a> when it is serving LDPCs.
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   509
LDP does not constrain its behavior when serving other HTTP resources.
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   510
</p>
71
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   511
</section>
5a2794d3ab13 ISSUE-31 Added a more complete conformance section, motived by SPARQL 1.1
sspeiche
parents: 69
diff changeset
   512
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   513
<section id="ldpr">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   514
<h1>Linked Data Platform Resources</h1>
222
1db581afd1ec Added informative section 4.1 , therefore shifting all sections by one 4.1->4.2, etc
sspeiche
parents: 221
diff changeset
   515
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   516
<section class="informative" id="ldpr-informative">
466
7b840138bdf1 editorial cleanup; substantive hits to ldpc delete, remove reqt for direct containers to materialize insertedContentRelation (since it's value is fixed)
John Arwe
parents: 465
diff changeset
   517
<h2>Introduction</h2>
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   518
	<p>Linked Data Platform Resources (<dfn><abbr title="Linked Data Platform Resources">LDPRs</abbr></dfn>) are HTTP resources
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   519
		that conform to the simple patterns and conventions in this section.
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   520
		HTTP requests to access, modify, create or delete LDPRs are accepted
372
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   521
		and processed by <a title="LDP server">LDP servers</a>. Most LDPRs are domain-specific resources
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   522
		that contain data for an entity in some domain, which could be
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   523
		commercial, governmental, scientific, religious, or other.</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   524
	<p>Some of the rules defined in this document provide
33
3c8c101f3f97 2012-12-28 - Fixed Typos. Separated some compound rules like 4.1.5. Rewording for clarity: 4.1.10,
John Arwe <johnarwe@us.ibm.com>
parents: 21
diff changeset
   525
		clarification and refinement of the base Linked Data rules [[LINKED-DATA]];
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   526
		others address additional needs.</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   527
	<p>The rules for Linked Data Platform Resources address basic
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   528
		questions such as:</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   529
	<ul>
231
38d1a7faf1c4 Various editorial comments from PA
sspeiche
parents: 230
diff changeset
   530
		<li>What resource representations should be used?</li>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   531
		<li>How is optimistic collision detection handled for updates?</li>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   532
		<li>What should client expectations be for changes to linked-to resources,
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   533
				such as type changes?</li>
547
d34ef0884d9e Fixed LC-2840 clarity on burden of constraint
sspeiche
parents: 542
diff changeset
   534
		<li>How can the server make it easy for the client to create resources?</li>
464
77fd28c9eb94 action-127 use tag [23]xx status code for paging; also change paging to be for LDP-RRs as a consequence of issue-89 vocab changes
John Arwe
parents: 463
diff changeset
   535
		<li>How	do I GET the representation of a large resource broken up into pages?</li>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   536
	</ul>
463
ae72388dbb82 start action-127 paging use of [23]xx response code; also changed 'informative' to 'non-normative' so sandro is happy[ier]
John Arwe
parents: 462
diff changeset
   537
	<p>Additional non-normative guidance is available in the <a
439
28beff0a4f89 Updated reference to LDP BPG editor's draft and added ref to LDP-UCR
sspeiche
parents: 438
diff changeset
   538
			href="https://dvcs.w3.org/hg/ldpwg/raw-file/default/ldp-bp/ldp-bp.html"
28beff0a4f89 Updated reference to LDP BPG editor's draft and added ref to LDP-UCR
sspeiche
parents: 438
diff changeset
   539
			class="external"
28beff0a4f89 Updated reference to LDP BPG editor's draft and added ref to LDP-UCR
sspeiche
parents: 438
diff changeset
   540
			title="LDP Best Practices and Guidelines"
28beff0a4f89 Updated reference to LDP BPG editor's draft and added ref to LDP-UCR
sspeiche
parents: 438
diff changeset
   541
			rel="nofollow">LDP Best Practices and Guidelines editor's draft</a> that addresses
37
3e92cccfe6a3 edits to 4., 4.1.2, 4.1.6, http method support (aside from GET on LDPRs, and HEAD, HTTP governs), 5.2.1 clarify, 5.3.2/5.3.3 allow 3xx
John Arwe <johnarwe@us.ibm.com>
parents: 33
diff changeset
   542
		questions such as:</p>
3e92cccfe6a3 edits to 4., 4.1.2, 4.1.6, http method support (aside from GET on LDPRs, and HEAD, HTTP governs), 5.2.1 clarify, 5.3.2/5.3.3 allow 3xx
John Arwe <johnarwe@us.ibm.com>
parents: 33
diff changeset
   543
	<ul>
3e92cccfe6a3 edits to 4., 4.1.2, 4.1.6, http method support (aside from GET on LDPRs, and HEAD, HTTP governs), 5.2.1 clarify, 5.3.2/5.3.3 allow 3xx
John Arwe <johnarwe@us.ibm.com>
parents: 33
diff changeset
   544
		<li>What literal value types should be used?</li>
3e92cccfe6a3 edits to 4., 4.1.2, 4.1.6, http method support (aside from GET on LDPRs, and HEAD, HTTP governs), 5.2.1 clarify, 5.3.2/5.3.3 allow 3xx
John Arwe <johnarwe@us.ibm.com>
parents: 33
diff changeset
   545
		<li>Are there some typical vocabularies that should be reused?</li>
3e92cccfe6a3 edits to 4., 4.1.2, 4.1.6, http method support (aside from GET on LDPRs, and HEAD, HTTP governs), 5.2.1 clarify, 5.3.2/5.3.3 allow 3xx
John Arwe <johnarwe@us.ibm.com>
parents: 33
diff changeset
   546
	</ul>
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   547
	<p>The following sections define the conformance rules for LDP servers when serving LDPRs.
497
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   548
	Companion non-normative documents describe additional guidelines for use when interacting with LDPRs. 
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   549
	</p>
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   550
	<p>LDP-RS's representations may be too big, one strategy is to break up the response representation
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   551
	into client consumable chunks called pages. A separate LDP specification outlines the conformance
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   552
	rules around pagination [[LDP-PAGING]].
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   553
	</p>
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   554
	<p>A LDP server can manage two kinds of <a title="Linked Data Platform Resources">LDPRs</a>, those resources whose state 
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   555
	is represented using RDF (LDP-RS) and those using other formats (LDP-NR).  LDP-RSs have the unique
461
64c0ca32c9e6 Cleanup from Action-123 add LDPR-RR and LDPR-BR
John Arwe
parents: 460
diff changeset
   556
	quality that their representation is based on RDF, which addresses a number of use cases from web metadata, open data 
496
94420c5678ae Reference cleanup and tweak LDP-RS term
sspeiche
parents: 495
diff changeset
   557
	models, machine processable information, and automated processing by software agents [[!rdf11-concepts]].  LDP-NRs are almost anything
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   558
	on the Web today: images, HTML pages, word processing documents, spreadsheets, etc. and LDP-RSs hold 
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   559
	metadata associated with LDP-NRs in some cases.
448
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   560
	</p>
451
f68e4a59fba1 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 450
diff changeset
   561
    <figure id="fig-ldpr-types">
448
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   562
        <img src="images/ldpr1.png" alt="Sample separation of Linked Data Platform Resource" />
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   563
        <figcaption>Samples of different types of LDPRs</figcaption>
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   564
    </figure>
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   565
    <p>The LDP-NRs and LDP-RSs are simply sub-types of LDPRs, as illustrated in <a href="#fig-ldpr-class"></a>.</p>  
448
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   566
    <figure id="fig-ldpr-class">
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   567
       <img src="images/ldpr2.png" alt="Class Diagram of Linked Data Platform Resource" />
491
16d872a712b6 Adopted container hierarchy and merged Indirect Container into Container
sspeiche
parents: 489
diff changeset
   568
       <figcaption>Class relationship of types of Linked Data Platform Resources</figcaption>
448
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   569
     </figure>
72e366f1195f ACTION-123 Added concepts of LDP-RDF-Resource and LDP-Binary-Resource
sspeiche
parents: 447
diff changeset
   570
	
222
1db581afd1ec Added informative section 4.1 , therefore shifting all sections by one 4.1->4.2, etc
sspeiche
parents: 221
diff changeset
   571
</section>
1db581afd1ec Added informative section 4.1 , therefore shifting all sections by one 4.1->4.2, etc
sspeiche
parents: 221
diff changeset
   572
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   573
<section id="ldpr-resource">
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   574
<h2>Resource</h2>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   575
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   576
<section id="ldpr-general">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   577
<h2>General</h2>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   578
		
637
87b108186dd5 clean up lingering 2616 references, adjust accept-post BNF for bis changes
John Arwe
parents: 636
diff changeset
   579
	<section id="ldpr-gen-http"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST at least be HTTP/1.1 conformant servers [[!RFC7230]].
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   580
	</h2></section><!-- Was 4.2.1 / #ldpr-4_2_1 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   581
	
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   582
	<section id="ldpr-gen-binary"><h2 class="normal"><a title="LDP server">LDP servers</a> MAY host a mixture of <a title="Linked Data Platform RDF Source">LDP-RSs</a>
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   583
	and <a title="Linked Data Platform Non-RDF Source">LDP-NRs</a>. For example, it
372
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   584
		is common for <a title="LDP server">LDP servers</a> to need to host binary or text resources
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   585
		that do not have useful RDF representations.</h2></section><!-- Was 4.2.3 / #ldpr-4_2_3 -->
69
0f9825dea52b Updating some simple formatting, reorganizing open issues and todos
sspeiche
parents: 68
diff changeset
   586
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   587
	<section id="ldpr-gen-etags"><h2 class="normal"><a title="LDP server">LDP server</a> responses MUST use entity tags (either 
579
fc520a8e75eb Clarify MUST etags on responses with representations and HEAD
sspeiche
parents: 566
diff changeset
   588
		weak or strong ones) as response <code>ETag</code> header values, for responses that contain resource representations or
580
d17c3d23800e Clarify MUST etags on responses with representations and HEAD
sspeiche
parents: 579
diff changeset
   589
		successful responses to HTTP <code>HEAD</code> requests.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   590
	</h2></section><!-- Was 4.2.8 / #ldpr-4_2_8 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   591
	
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   592
	<section id="ldpr-gen-linktypehdr"><h2 class="normal"><a title="LDP server">LDP servers</a>
434
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   593
		exposing LDPRs 
149
3f5f825f1155 issue-57 How can a client determine that it is in communication with an LDP server?
John Arwe
parents: 134
diff changeset
   594
		MUST advertise their LDP support by exposing a HTTP <code>Link</code> header
454
4a28a15ee8fd ACTION-120 (complete) Updated LDPC general, GET and POST sections
sspeiche
parents: 453
diff changeset
   595
		with a target URI of <code>http://www.w3.org/ns/ldp#Resource</code>, and
402
935e1e08d2bb Fix some typos around paging, move to single quotes for link relations per 5988
John Arwe
parents: 395
diff changeset
   596
		a link relation type of <code>type</code> (that is, <code>rel='type'</code>)
149
3f5f825f1155 issue-57 How can a client determine that it is in communication with an LDP server?
John Arwe
parents: 134
diff changeset
   597
		in all responses to requests made 
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   598
		to an LDPR's HTTP <code>Request-URI</code> [[!RFC5988]]. 
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   599
	</h2></section><!-- Was 4.2.10 / #ldpr-4_2_10 -->
434
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   600
	<blockquote>
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   601
		<p>
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   602
		Note: 
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   603
		The HTTP <code>Link</code> header is the method by which servers assert their support for the LDP specification 
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   604
		on a specific resource in a way that clients can inspect dynamically at run-time.   
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   605
		This is <strong>not</strong> equivalent to the
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
   606
		presence of a <var>(subject-URI, <code>rdf:type</code>, <code>ldp:Resource</code>)</var> triple in an LDP-RS.
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   607
		The presence of the header asserts that the server complies with the LDP specification's constraints on 
434
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   608
		HTTP interactions with LDPRs, that is
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   609
		it asserts that the resource <a href="#ldpr-gen-etags">has Etags</a>, <a href="#ldpr-options-must">supports OPTIONS</a>, and so on,
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   610
		which is not true of all Web resources.
434
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   611
		</p>
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   612
		<p>
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   613
		Note: 
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   614
		<a href="#ldpr-gen-binary">A LDP server can host a mixture of LDP-RSs and LDP-NRs</a>, and therefore there is no implication
192
221002315344 Removed 4.1.5 and various formatting issues
sspeiche
parents: 191
diff changeset
   615
		that LDP support advertised on one HTTP <code>Request-URI</code> means that other 
221002315344 Removed 4.1.5 and various formatting issues
sspeiche
parents: 191
diff changeset
   616
		resources on the same server are also LDPRs.  Each HTTP <code>Request-URI</code> needs to be 
434
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   617
		individually inspected, in the absence of outside information.
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   618
		</p>
83b656184387 Action-122 close ISSUE-91, by adding that for an LDPC the link header is type=LDPC
John Arwe
parents: 433
diff changeset
   619
	</blockquote>
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   620
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   621
	<section id="ldpr-gen-defbaseuri"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST assign the default 
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   622
		base-URI for [[!RFC3987]] relative-URI resolution to be the HTTP 
224
39ca65760446 Removed 5.4.8.1 and added 4.2.12 to better handle base/rel URI
sspeiche
parents: 223
diff changeset
   623
		<code>Request-URI</code> when the resource already exists, and to the URI of the created resource when the request results 
39ca65760446 Removed 5.4.8.1 and added 4.2.12 to better handle base/rel URI
sspeiche
parents: 223
diff changeset
   624
		in the creation of a new resource.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   625
	</h2></section><!-- Was 4.2.12 / #ldpr-4_2_12 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   626
	
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   627
	<section id="ldpr-gen-pubclireqs"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST 
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   628
		publish any constraints on <a title="LDP client">LDP clients’</a> ability to 
402
935e1e08d2bb Fix some typos around paging, move to single quotes for link relations per 5988
John Arwe
parents: 395
diff changeset
   629
		create or update LDPRs, by adding a Link header with <code>rel='describedby'</code> 
504
065e49b91d0b Corrected rel=meta to be rel=describedBy
sspeiche
parents: 503
diff changeset
   630
		[[!RFC5988]] to all responses to requests which fail due to violation of 
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   631
		those constraints.  For example, a server that refuses resource creation 
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   632
		requests via HTTP PUT, POST, or PATCH would return this <code>Link</code> header on its 
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   633
		4xx responses to such requests.
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   634
		The same <code>Link</code> header MAY be provided on other responses.  LDP neither 
504
065e49b91d0b Corrected rel=meta to be rel=describedBy
sspeiche
parents: 503
diff changeset
   635
		defines nor constrains the representation of the link's target resource.  Natural language 
065e49b91d0b Corrected rel=meta to be rel=describedBy
sspeiche
parents: 503
diff changeset
   636
		constraint documents are therefore permitted, 
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   637
		although machine-readable ones facilitate better client interactions.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   638
	</h2></section><!-- Was 4.2.13 / #ldpr-4_2_13 -->
152
938e7d21cc10 issue-78 inferencing levels add 4.1.13
John Arwe
parents: 151
diff changeset
   639
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   640
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   641
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   642
<section id="ldpr-HTTP_GET">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   643
<h2>HTTP GET</h2>
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   644
	<section id="ldpr-get-must"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST support the HTTP <code>GET</code> Method for LDPRs.
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   645
	</h2></section><!-- Was 4.3.1 / #ldpr-4_3_1 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   646
	
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   647
	<section id="ldpr-get-options"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST support the HTTP response headers defined in 
228
ec118c66c122 Moved 4.7.2 (from HEAD) to 4.3.2 (GET), shifted rest of GET section by one
sspeiche
parents: 227
diff changeset
   648
		<a href="#ldpr-HTTP_OPTIONS" class="sectionRef"></a>.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   649
	</h2></section><!-- Was 4.3.2 / #ldpr-4_3_2 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   650
	
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   651
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   652
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   653
<section id="ldpr-HTTP_POST">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   654
<h2>HTTP POST</h2>
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   655
	<p>
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   656
		Per [[!RFC7231]], this HTTP method is optional and 
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   657
		this specification does not require <a title="LDP server">LDP servers</a> to support it.
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   658
		When a LDP server supports this method, 
485
195cdbad4852 Updated LDPR Post reference to Put, which had implied that clients could PUT (to an LDPC) to create an LDPR
John Arwe
parents: 484
diff changeset
   659
		this specification imposes no new requirements for LDPRs.
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   660
	</p>
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
   661
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   662
	<p>Clients can create LDPRs via <code>POST</code> (<a href="#ldpc-HTTP_POST" class="sectionRef"></a>) to a LDPC, 
485
195cdbad4852 Updated LDPR Post reference to Put, which had implied that clients could PUT (to an LDPC) to create an LDPR
John Arwe
parents: 484
diff changeset
   663
		via <code>PUT</code> (<a href="#ldpr-HTTP_PUT" class="sectionRef"></a>), or any other methods allowed
195cdbad4852 Updated LDPR Post reference to Put, which had implied that clients could PUT (to an LDPC) to create an LDPR
John Arwe
parents: 484
diff changeset
   664
		for HTTP resources.  Any server-imposed constraints on LDPR creation or update  
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   665
		<a href="#ldpr-gen-pubclireqs">must be advertised</a> to clients.
480
96f2d9c4a742 Updated LDPC DELETE language and cleanup todos
sspeiche
parents: 479
diff changeset
   666
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   667
	</p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   668
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   669
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   670
<section id="ldpr-HTTP_PUT">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   671
<h2>HTTP PUT</h2>
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   672
	<p>
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   673
		Per [[!RFC7231]], this HTTP method is optional and 
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   674
		this specification does not require <a title="LDP server">LDP servers</a> to support it.
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   675
		When a LDP server supports this method, 
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   676
		this specification imposes the following new requirements for LDPRs.
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   677
	</p>
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   678
		
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   679
	<p>
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   680
		Any server-imposed constraints on LDPR creation or update  
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   681
		<a href="#ldpr-gen-pubclireqs">must be advertised</a> to clients.
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   682
	</p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   683
		
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   684
	<section id="ldpr-put-replaceall"><h2 class="normal">If a HTTP <code>PUT</code> is accepted on an existing resource, 
389
f1dbb042137b Resolve ACTION-109 Update spec to reflect 10/21 resolution for ignoring triples on PUT
John Arwe
parents: 388
diff changeset
   685
		<a title="LDP server">LDP servers</a> MUST
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   686
		replace the entire persistent state of the identified resource with
61
2f8a2d58e65c ISSUE-11 - 4.4.1 Relaxed the MUST ignore dc:modified/creator to MAY
sspeiche
parents: 60
diff changeset
   687
		the entity representation in the body of the request. 
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   688
		<a title="LDP server">LDP servers</a> MAY ignore server-managed properties such as <code>dcterms:modified</code> 
61
2f8a2d58e65c ISSUE-11 - 4.4.1 Relaxed the MUST ignore dc:modified/creator to MAY
sspeiche
parents: 60
diff changeset
   689
		and <code>dcterms:creator</code> if they are not under
372
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   690
		client control. Any <a title="LDP server">LDP servers</a> that wish
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   691
		to support a more sophisticated merge of data provided by the client
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   692
		with existing state stored on the server for a resource MUST use HTTP
192
221002315344 Removed 4.1.5 and various formatting issues
sspeiche
parents: 191
diff changeset
   693
		<code>PATCH</code>, not HTTP <code>PUT</code>.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   694
	</h2></section><!-- Was 4.5.1 / #ldpr-4_5_1 -->
519
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   695
		
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   696
	<section id="ldpr-put-simpleupdate"><h2 class="normal"><a title="LDP server">LDP servers</a> SHOULD allow clients to update resources without
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   697
		requiring detailed knowledge of server-specific constraints.  
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   698
		This is a consequence of the requirement to enable simple creation and modification of LDPRs.
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   699
	</h2></section><!-- Was 4.5.7 / #ldpr-4_5_7 -->	
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   700
519
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   701
	<section id="ldprs-put-servermanagedprops"><h2 class="normal">
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   702
		If an otherwise valid HTTP <code>PUT</code> request is received 
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   703
		that attempts to change properties the server does not allow clients to modify, 
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   704
		<a title="LDP server">LDP servers</a> MUST 
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   705
		fail the request by responding with a 4xx range status code (typically
519
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   706
		409 Conflict). 
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   707
		<a title="LDP server">LDP servers</a> SHOULD provide a corresponding response body containing
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   708
		information about which properties could not be
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   709
		persisted.
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   710
		The format of the 4xx response body is not constrained by LDP.
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   711
	</h2></section><!-- Was 4.5.1.1 / #ldpr-4_5_1_1 -->
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   712
	<blockquote>
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   713
		Non-normative note: Clients might provide properties equivalent to those already in the resource's state,
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   714
		e.g. as part of a GET/update representation/PUT sequence, and those PUT requests are intended to work as long as the 
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   715
		server-managed properties 
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   716
		are identical on the GET response and the subsequent PUT request.
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   717
		This is in contrast to other cases like write-once properties that the server does not allow clients to modify once set; 
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   718
		write-once properties are under client control, they are not <a href="#ldpr-put-replaceall">server-managed</a>.
519
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   719
	</blockquote>
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   720
	
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   721
	<section id="ldprs-put-failed"><h2 class="normal">
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   722
		If an otherwise valid HTTP <code>PUT</code> request is received that contains properties the server 
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   723
		chooses not to persist, e.g. unknown content,
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   724
		<a title="LDP server">LDP servers</a> MUST respond with an appropriate 4xx range status code
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   725
		[[!RFC7231]].  
519
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   726
		<a title="LDP server">LDP servers</a> SHOULD provide a corresponding response body containing
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   727
		information about which properties could not be
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   728
		persisted.
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   729
		The format of the 4xx response body is not constrained by LDP. LDP servers
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   730
		expose these application-specific constraints as described in <a href="#ldpr-general" class="sectionRef"></a>.
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   731
	</h2></section><!-- Was 4.5.4 / #ldpr-4_5_4 -->
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   732
	
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   733
	<section id="ldpr-put-precond"><h2 class="normal"><a title="LDP client">LDP clients</a> SHOULD use the HTTP <code>If-Match</code>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   734
		header and HTTP <code>ETags</code> to ensure it isn’t
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   735
		modifying a resource that has changed since the client last retrieved
372
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   736
		its representation. <a title="LDP server">LDP servers</a> SHOULD require the HTTP <code>If-Match</code> header and HTTP <code>ETags</code>
d85ca5c8cb68 Preparing for profiles - conformance section updates; add link to IETF draft
John Arwe
parents: 370
diff changeset
   737
		to detect collisions. <a title="LDP server">LDP servers</a> MUST respond with status code 412
122
14197f56039e Issue-74 resolution - 428 precondition required
John Arwe
parents: 120
diff changeset
   738
		(Condition Failed) if <code>ETag</code>s fail to match when there are no other
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   739
		errors with the request [[!RFC7232]].  <a title="LDP server">LDP servers</a> that require conditional requests MUST respond with status code 428
122
14197f56039e Issue-74 resolution - 428 precondition required
John Arwe
parents: 120
diff changeset
   740
		(Precondition Required) when the absence of a precondition is the only reason for rejecting the request [[!RFC6585]].
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   741
	</h2></section><!-- Was 4.5.2 / #ldpr-4_5_2 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   742
	
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   743
	<section id="ldpr-put-create"><h2 class="normal"><a title="LDP server">LDP servers</a> MAY choose to allow the creation of new resources using HTTP <code>PUT</code>.
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   744
	</h2></section><!-- Was 4.5.6 / #ldpr-4_5_6 -->
519
0a61b68f0a67 Tweaked LDPR PUT clauses to better match new defn of LDPR
sspeiche
parents: 518
diff changeset
   745
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   746
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   747
		
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   748
<section id="ldpr-HTTP_DELETE">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   749
<h2>HTTP DELETE</h2>
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   750
	<p>
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   751
		Per [[!RFC7231]], this HTTP method is optional and 
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   752
		this specification does not require <a title="LDP server">LDP servers</a> to support it.
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   753
		When a LDP server supports this method, 
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   754
		this specification imposes no new blanket requirements for LDPRs.
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   755
	</p>
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   756
		
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   757
	<p>Additional requirements on HTTP <code>DELETE</code> for LDPRs within containers can be found in
466
7b840138bdf1 editorial cleanup; substantive hits to ldpc delete, remove reqt for direct containers to materialize insertedContentRelation (since it's value is fixed)
John Arwe
parents: 465
diff changeset
   758
	<a href="#ldpc-HTTP_DELETE" class="sectionRef"></a>.
7b840138bdf1 editorial cleanup; substantive hits to ldpc delete, remove reqt for direct containers to materialize insertedContentRelation (since it's value is fixed)
John Arwe
parents: 465
diff changeset
   759
	</p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   760
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   761
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   762
<section id="ldpr-HTTP_HEAD">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   763
<h2>HTTP HEAD</h2>
515
9f5b3854a5bb Fixed a number of broken links
sspeiche
parents: 514
diff changeset
   764
	<p>Note that certain LDP mechanisms rely on HTTP headers, and HTTP generally requires that
192
221002315344 Removed 4.1.5 and various formatting issues
sspeiche
parents: 191
diff changeset
   765
		<code>HEAD</code> responses include the same headers as <code>GET</code> responses.  
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   766
		Thus, implementers should also carefully read sections <a href="#ldpr-HTTP_GET"></a> 
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   767
		and <a href="#ldpr-HTTP_OPTIONS"></a>.</p>
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   768
	<section id="ldpr-head-must"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST support the HTTP <code>HEAD</code> method.
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   769
	</h2></section><!-- Was 4.7.1 / #ldpr-4_7_1 -->
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   770
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   771
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   772
<section id="ldpr-HTTP_PATCH">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   773
<h2>HTTP PATCH</h2>
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   774
	<p>
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   775
		Per [[!RFC5789]], this HTTP method is optional and 
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   776
		this specification does not require <a title="LDP server">LDP servers</a> to support it.
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   777
		When a LDP server supports this method, 
475
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   778
		this specification imposes the following new requirements for LDPRs.
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   779
	</p>
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   780
		
e36ed82a31a7 Put final stake in heart of 'informative' (waves to Sandro), update boilerplate for readability per Arnaud
John Arwe
parents: 474
diff changeset
   781
	<p>
393
8197019f4604 ACTION-110 Update spec to reflect 10/21 resolution for normative changes to align vanilla/chocolate
John Arwe
parents: 389
diff changeset
   782
		Any server-imposed constraints on LDPR creation or update  
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   783
		<a href="#ldpr-gen-pubclireqs">must be advertised</a> to clients.
500
c52f08081c8a Removed rule on PATCH create, as it doesn't add any substantive over RFC5789
sspeiche
parents: 498
diff changeset
   784
	</p>
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   785
	
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   786
	<section id="ldpr-patch-acceptpatch"><h2 class="normal"><a title="LDP server">LDP servers</a> that support <code>PATCH</code> MUST
158
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   787
		include an <code>Accept-Patch</code> HTTP response header [[!RFC5789]] on HTTP <code>OPTIONS</code>
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   788
		requests, listing patch document media type(s) supported by the server.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   789
	</h2></section><!-- Was 4.8.4 / #ldpr-4_8_4 -->
186
a3471f4667d8 Removed closed issues that required no new spec changes: 50, 56, 16, 19, 17
sspeiche
parents: 185
diff changeset
   790
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   791
</section>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   792
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   793
<section id="ldpr-HTTP_OPTIONS">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   794
<h2>HTTP OPTIONS</h2>
158
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   795
	<p>This specification imposes the following new requirements on HTTP <code>OPTIONS</code> for LDPRs 
637
87b108186dd5 clean up lingering 2616 references, adjust accept-post BNF for bis changes
John Arwe
parents: 636
diff changeset
   796
		beyond those in [[!RFC7231]].  Other sections of this specification, for example 
167
ae4592939639 issue-80 Add Accept-Post
John Arwe
parents: 158
diff changeset
   797
		<a href="#ldpr-HTTP_PATCH">PATCH</a>,
481
beb136ede044 Removed LDPR Paging HTTP OPTIONS section (no longer needed) and more cleanup of todos
sspeiche
parents: 480
diff changeset
   798
		<a href="#header-accept-post">Accept-Post</a>,
158
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   799
		add other requirements on <code>OPTIONS</code> responses.
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   800
		</p>
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   801
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   802
	<section id="ldpr-options-must"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST support the HTTP <code>OPTIONS</code> method.
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   803
	</h2></section><!-- Was 4.9.1 / #ldpr-4_9_1 -->
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   804
		
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   805
	<section id="ldpr-options-allow"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST indicate their support for HTTP Methods by
158
8af0b25f2748 issue-32 MUST support OPTIONS
John Arwe
parents: 152
diff changeset
   806
		responding to a HTTP <code>OPTIONS</code> request on the LDPR’s URL with the HTTP
192
221002315344 Removed 4.1.5 and various formatting issues
sspeiche
parents: 191
diff changeset
   807
		Method tokens in the HTTP response header <code>Allow</code>.
435
e9efbc3a3ba8 First attempt at correcting section ordering and anchors
sspeiche
parents: 434
diff changeset
   808
	</h2></section><!-- Was 4.9.2 / #ldpr-4_9_2 -->
134
917946ac571e ISSUE-33 Moved 5.1.3 Paging (LDPC) to 4.8 (LDPR)
sspeiche
parents: 130
diff changeset
   809
174
72ce83f4ec7f issue-58 actions 88,89 (new predicates)
John Arwe
parents: 173
diff changeset
   810
</section> <!-- h2 -->
72ce83f4ec7f issue-58 actions 88,89 (new predicates)
John Arwe
parents: 173
diff changeset
   811
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   812
</section> <!-- ldpr-resource -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   813
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   814
<section id="ldprs">
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   815
<h2>RDF Source</h2>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   816
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   817
<p>The following section contains normative clauses for <a title="">Linked Data Platform RDF Source</a>.</p>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   818
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   819
<section id="ldprs-general">
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   820
<h2>General</h2>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   821
516
b46f235b5fcc Fixed biblio and dfn references
sspeiche
parents: 515
diff changeset
   822
	<section id="ldprs-are-ldpr"><h2 class="normal">Each <a title="Linked Data Platform RDF Source">LDP RDF Source</a> MUST also be 
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   823
		a conforming <a title="Linked Data Platform Resource">LDP Resource</a> as defined in <a href="#ldpr-resource" class="sectionRef"></a>, along with the
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   824
		restrictions in this section. <a title="">LDP client</a>s MAY infer the following triple: one
553
3d27d1a1d553 change subclassof to rdf:type for MAY inferred triples
John Arwe
parents: 552
diff changeset
   825
		whose subject is the <a title="Linked Data Platform RDF Source">LDP-RS</a>, 
3d27d1a1d553 change subclassof to rdf:type for MAY inferred triples
John Arwe
parents: 552
diff changeset
   826
		whose predicate is <code>rdf:type</code>, 
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   827
		and whose object is <code>ldp:Resource</code>, 
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   828
		but there is no requirement to materialize this triple in the LDP-RS representation.
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   829
	</h2></section>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   830
	
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   831
	<section id="ldprs-gen-atleast1rdftype"><h2 class="normal"><a title="Linked Data Platform RDF Source">LDP-RSs</a> representations SHOULD have at least one <code>rdf:type</code>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   832
		set explicitly.  This makes the representations much more useful to
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   833
		client applications that don’t support inferencing.
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   834
	</h2></section><!-- Was 4.2.5 / #ldpr-4_2_5 -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   835
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   836
	<section id="ldprs-rdftype"><h2 class="normal">The representation of a LDP-RS MAY have an <code>rdf:type</code>
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   837
		of <code>ldp:RDFSource</code> for <a title="">Linked Data Platform RDF Source</a>.
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   838
	</h2></section><!-- Was 5.2.7 / #ldpc-5_2_7 -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   839
		
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   840
	<section id="ldprs-gen-rdf"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST provide an RDF representation for <a title="Linked Data Platform RDF Source">LDP-RSs</a>. 
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   841
	The HTTP <code>Request-URI</code> of the LDP-RS is typically the subject of most triples in the response.
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   842
	</h2></section><!-- Was 4.2.2 / #ldpr-4_2_2 -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   843
	
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   844
	<section id="ldprs-gen-reusevocab"><h2 class="normal"><a title="Linked Data Platform RDF Source">LDP-RSs</a> SHOULD reuse existing vocabularies instead of creating
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   845
		their own duplicate vocabulary terms.  In addition to this general rule, some specific cases are
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   846
		covered by other conformance rules.
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   847
	</h2></section><!-- Was 4.2.4 / #ldpr-4_2_4 -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   848
	
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   849
	<section id="ldprs-gen-reusevocabsuchas"><h2 class="normal"><a title="Linked Data Platform RDF Source">LDP-RSs</a> predicates SHOULD use standard vocabularies such as Dublin Core
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   850
		[[!DC-TERMS]], RDF [[!rdf11-concepts]] and RDF Schema [[!rdf-schema]], whenever
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   851
		possible.
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   852
	</h2></section><!-- Was 4.2.4.1 / #ldpr-4_2_4_1 -->
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   853
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   854
	<section id="ldp-cli-multitype"><h2 class="normal">In the absence of special knowledge of the application or domain, 
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   855
		<a title="LDP client">LDP clients</a> MUST assume that any LDP-RS can have multiple <code>rdf:type</code> triples with different objects.
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   856
	</h2></section> <!-- Was 4.3.5 / #ldpr-4_3_5 -->
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   857
	
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   858
	<section id="ldpr-cli-typeschange"><h2 class="normal">In the absence of special knowledge of the application or domain, 
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   859
		<a title="LDP client">LDP clients</a> MUST assume that the <code>rdf:type</code> values
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   860
		of a given LDP-RS can change over time.
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   861
	</h2></section> <!-- Was 4.3.6 / #ldpr-4_3_6 -->
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   862
	
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   863
	<section id="ldpr-cli-openpreds"><h2 class="normal"><a title="LDP client">LDP clients</a> SHOULD always assume that the set of predicates for a
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   864
		LDP-RS of a particular type at an arbitrary server is open, in the
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   865
		sense that different resources of the same type may not all have the
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   866
		same set of predicates in their triples, and the set of predicates that
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   867
		are used in the state of any one LDP-RS is not limited to any pre-defined
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   868
		set.
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   869
	</h2></section> <!-- Was 4.5.3 / #ldpr-ldpr-4_5_3 -->
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   870
		
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   871
	<section id="ldprs-gen-noinferencing"><h2 class="normal"><a title="LDP server">LDP servers</a>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   872
		MUST NOT require LDP clients to implement inferencing in order to recognize the subset
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   873
		of content defined by LDP.  Other specifications built on top of LDP may require clients
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   874
		to implement inferencing [[!rdf11-concepts]].  The practical implication is that all content defined by LDP
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   875
		must be explicitly represented, unless noted otherwise within this document.
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   876
	</h2></section><!-- Was 4.2.11 / #ldpr-4_2_11 -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   877
	
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   878
	<section id="ldpr-cli-preservetriples"><h2 class="normal">
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   879
		A <a title="LDP client">LDP client</a> MUST preserve all triples retrieved from a LDP-RS using HTTP <code>GET</code> that
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   880
		it doesn’t change whether it understands the predicates or not, when
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   881
		its intent is to perform an update using HTTP <code>PUT</code>.  The use of HTTP
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   882
		<code>PATCH</code> instead of HTTP <code>PUT</code> for update avoids this burden for clients
636
46b0ed651256 updated to use RFC numbers newly assigned to http-bis and prefer header
John Arwe
parents: 634
diff changeset
   883
		[[!RFC5789]].
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   884
	</h2></section> <!-- Was 4.5.5 / #ldpr-ldpr-4_5_5 -->
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   885
	
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   886
	<section id="ldpr-cli-can-hint"><h2 class="normal">
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   887
		<a title="LDP client">LDP clients</a> MAY 
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   888
		provide LDP-defined hints that allow servers to optimize the content of responses.
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   889
		<a href="#prefer-parameters" class="sectionRef"></a> defines hints that apply to 
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   890
		<a title="Linked Data Platform RDF Source">LDP-RSs</a>.
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   891
	</h2></section> 
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   892
	
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   893
	<section id="ldpr-cli-hints-ignorable"><h2 class="normal">
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   894
		<a title="LDP client">LDP clients</a> MUST 
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   895
		be capable of processing responses formed by a LDP server that ignores hints,
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   896
		including LDP-defined hints.
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   897
	</h2></section>
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   898
	
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   899
	<div class="atrisk" id="atrisk-paging"><p class="atrisktext">Feature At Risk</p>
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   900
	<p>The LDP Working Group proposes incorporation of the following clause to make LDP clients paging aware:</p>
527
b86124412c7a html5 validation fixes
sspeiche
parents: 525
diff changeset
   901
	<section id="ldpr-cli-paging"><h2 class="normal">
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   902
		<a title="LDP client">LDP clients</a> SHOULD 
552
4d99968383f2 editorial changes - "an" to "a" etc
John Arwe
parents: 551
diff changeset
   903
		be capable of processing successful HTTP <code>GET</code> responses formed by a LDP server
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   904
		that independently initiated paging, returning a page of representation instead of full resource
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   905
		representation [[!LDP-PAGING]].
527
b86124412c7a html5 validation fixes
sspeiche
parents: 525
diff changeset
   906
	</h2>
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   907
	</section> 
527
b86124412c7a html5 validation fixes
sspeiche
parents: 525
diff changeset
   908
	</div>
518
f64cf213ec81 Folded #ldpclients section into #ldprs
sspeiche
parents: 517
diff changeset
   909
	
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   910
</section> <!-- ldprs-general -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   911
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   912
<section id="ldprs-HTTP_GET">
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   913
<h2>HTTP GET</h2>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   914
	<section id="ldprs-get-turtle"><h2 class="normal"><a title="LDP server">LDP servers</a> MUST provide a <code>text/turtle</code>
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   915
		representation of the requested <a title="Linked Data Platform RDF Source">LDP-RS</a> whenever HTTP content negotiation
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   916
		does not force another outcome [[!turtle]].  In other words, if the server receives a <code>GET</code> request whose <code>Request-URI</code>
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   917
		identifies a <a title="">LDP-RS</a>, and either <code>text/turtle</code> has the highest relative quality
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   918
		factor (<code>q=</code> value) in the 
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   919
		Accept request header or that header is absent, then an <a title="">LDP server</a> has to respond with Turtle.
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   920
	</h2></section><!-- Was 4.3.3 / #ldpr-4_3_3 -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   921
600
67d13fb3a21f changes motivated by joe ross's comments
John Arwe
parents: 585
diff changeset
   922
	<section id="ldprs-get-jsonld"><h2 class="normal"><a title="LDP server">LDP servers</a> SHOULD offer a <code>application/ld+json</code>
565
76006e897d7f Servers should offer/accept JSON-LD representations of LDP-RSs
John Arwe
parents: 564
diff changeset
   923
		representation of the requested <a title="Linked Data Platform RDF Source">LDP-RS</a> [[!JSON-LD]].
76006e897d7f Servers should offer/accept JSON-LD representations of LDP-RSs
John Arwe
parents: 564
diff changeset
   924
	</h2></section><!-- new -->
76006e897d7f Servers should offer/accept JSON-LD representations of LDP-RSs
John Arwe
parents: 564
diff changeset
   925
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   926
</section> <!-- ldprs-HTTP_GET -->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   927
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   928
</section> <!-- ldprs RDF Source-->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   929
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   930
<section id="ldpnr">
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   931
<h2>Non-RDF Source</h2>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   932
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   933
<p>The following section contains normative clauses for <a title="">Linked Data Platform Non-RDF Source</a>.</p>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   934
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   935
<section id="ldpnr-general">
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   936
<h2>General</h2>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   937
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   938
	<section id="ldpnr-are-ldpr"><h2 class="normal">Each <a title="Linked Data Platform Non-RDF Source">LDP Non-RDF Source</a> MUST also be 
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   939
		a conforming <a title="Linked Data Platform Resource">LDP Resource</a> in <a href="#ldpr-resource" class="sectionRef"></a>.  
548
ab2a3418fb01 minor editorial fixes
John Arwe
parents: 547
diff changeset
   940
		<a title="Linked Data Platform Non-RDF Source">LDP Non-RDF Sources</a> may not be able to fully express their
583
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   941
		state using RDF [[rdf11-concepts]]. 
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   942
	</h2></section>
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   943
	
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   944
	<section id="ldpnr-type"><h2 class="normal"><a title="LDP server">LDP servers</a> exposing an <a title="Linked Data Platform Non-RDF Source">LDP Non-RDF Source</a> 
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   945
		MAY advertise this by exposing a HTTP <code>Link</code> header
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   946
		with a target URI of <code>http://www.w3.org/ns/ldp#NonRDFSource</code>, and
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   947
		a link relation type of <code>type</code> (that is, <code>rel='type'</code>)
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   948
		in responses to requests made 
196b408851fd Added usage for ldp:NonLDPSource
sspeiche
parents: 580
diff changeset
   949
		to the LDP-NR's HTTP <code>Request-URI</code> [[!RFC5988]].  
513
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   950
	</h2></section>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   951
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   952
</section> <!-- ldpnr Non-RDF Source-->
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   953
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   954
</section>
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   955
2df2933649d4 Split out different kinds of LDPRs into their own subsection
sspeiche
parents: 512
diff changeset
   956
</section> <!-- ldpr h1 -->
174
72ce83f4ec7f issue-58 actions 88,89 (new predicates)
John Arwe
parents: 173
diff changeset
   957
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   958
<section id="ldpc">
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   959
<h1>Linked Data Platform Containers</h1>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   960
333
3c2aaaea1f73 Fixed vanishing section ref problem
sspeiche
parents: 331
diff changeset
   961
<section class="informative" id="ldpc-informative">		
466
7b840138bdf1 editorial cleanup; substantive hits to ldpc delete, remove reqt for direct containers to materialize insertedContentRelation (since it's value is fixed)
John Arwe
parents: 465
diff changeset
   962
<h2>Introduction</h2>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   963
	<p>Many HTTP applications and sites have organizing
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   964
		concepts that partition the overall space of resources into smaller
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   965
		containers. Blog posts are grouped into blogs, wiki pages are grouped
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   966
		into wikis, and products are grouped into catalogs. Each resource
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   967
		created in the application or site is created within an instance of
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   968
		one of these container-like entities, and users can list the existing
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   969
		artifacts within one. Containers answer some basic questions, which
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   970
		are:</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   971
	<ol>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   972
		<li>To which URLs can I POST to create new resources?</li>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   973
		<li>Where can I GET a list of existing resources?</li>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   974
		<li>How do I get information about the members along with the container?</li>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   975
		<li>How	can I ensure the resource data is easy to query?</li>
497
67f04abb73e6 Factored out paging and sorting into separate spec LDP-Paging
sspeiche
parents: 496
diff changeset
   976
		<li>How	is the order of the container entries expressed? [[LDP-PAGING]]</li>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   977
	</ol>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   978
	<p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   979
		This document defines the representation and behavior of containers
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   980
		that address these issues. There are multiple types of containers defined
509
3b515a98338d fixed typos, removed empty section, fixed mixed set of "an LDP" and "a LDP"
Arnaud Le Hors <lehors@us.ibm.com>
parents: 508
diff changeset
   981
		to support a variety of use cases, all that support a base set of capabilities.
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   982
		The contents of a container is
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   983
		defined by a set of triples in its representation (and state) called
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   984
		the <a title="Containment triples">containment triples</a> that follow a fixed pattern.
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   985
		Additional types of containers allow for the set of members of a container to be
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
   986
		defined by a set of triples in its representation called
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   987
		the <a title="Membership triples">membership triples</a> that follow a consistent pattern
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   988
		(see the linked-to definition for the possible patterns). 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   989
		The membership triples of a container all
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   990
		have the same predicate, called the membership predicate, 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   991
		and either the subject or the object is also a consistent value
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   992
		– the remaining position of the membership
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   993
		triples (the one that varies) define the members of the container. 
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   994
		In the simplest cases, the
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
   995
		consistent value will be the LDPC resource's URI, but it does not
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   996
		have to be. The membership predicate is also variable and will often
453
a70c321daf12 ACTION-120 (Part 3) Added ldp:member
sspeiche
parents: 452
diff changeset
   997
		be a predicate from the server application vocabulary or the <code>ldp:member</code> predicate.
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   998
	</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
   999
	<p>This document includes a set of guidelines for
415
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
  1000
		creating new resources and adding them to the list of
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1001
		resources linked to a container. It goes on to explain how to learn about a set of related
415
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
  1002
		resources, regardless of how they were created or added to the container's membership.
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
  1003
		It also defines behavior when resources created using a container are later deleted;
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
  1004
		deleting containers removes membership information and
12864dde579d Resolve ACTION-112 Update spec to reflect 10/28 resolution for Issue-81 part 1: new predicate names
John Arwe
parents: 414
diff changeset
  1005
		possibly performs some cleanup tasks on unreferenced member resources.</p>
104
78fd14175304 ISSUE-59 5.3.2 limited rdf:type of ldp:Container, removed 5.6.3, reworded 5.6.2, updated 1.
sspeiche
parents: 102
diff changeset
  1006
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1007
	<p>The following illustrates a very simple
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1008
		container with only three members and some information about the
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1009
		container (the fact that it is a container and a brief title):</p>
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1010
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1011
<em>Request</em> to <code>http://example.org/c1/</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1012
<pre class="example" id="ldpc-ex-simple-req">GET /c1/ HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1013
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1014
Accept: text/turtle</pre>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1015
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1016
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1017
<pre class="example" id="ldpc-ex-simple">HTTP/1.1 200 OK
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1018
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1019
Date: Thu, 12 Jun 2014 18:26:59 GMT
653
71bc4ab13849 Fixed ETag headers to be strong and quoted
sspeiche
parents: 647
diff changeset
  1020
ETag: "8caab0784220148bfe98b738d5bb6d13"
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1021
Accept-Post: text/turtle, application/ld+json
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1022
Allow: POST,GET,OPTIONS,HEAD,PUT
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1023
Link: &lt;http://www.w3.org/ns/ldp#BasicContainer&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1024
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
646
d97c97e51f86 Updated examples in Prefer section to be in request/response format
sspeiche
parents: 644
diff changeset
  1025
Transfer-Encoding: chunked
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1026
<!-- @base <http://example.org/c1/>. -->
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1027
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1028
@prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1029
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1030
&lt;http://example.org/c1/&gt;
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1031
   a ldp:BasicContainer;
486
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
  1032
   dcterms:title "A very simple container";
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
  1033
   ldp:contains &lt;r1&gt;, &lt;r2&gt;, &lt;r3&gt;.</pre>
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1034
 
522
b3fd53a7b048 Prepare for LC2
sspeiche
parents: 521
diff changeset
  1035
 <!-- TODO: consider if basic container diagram helps, if so...add for other cases too
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1036
   	<figure id="fig-ldpc-basic">
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1037
        <img src="images/ldpc-basic.png" alt="Sample Linked Data Platform Basic Container" />
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1038
        <figcaption>Sample of Linked Data Platform Basic Container</figcaption>
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1039
    </figure>
522
b3fd53a7b048 Prepare for LC2
sspeiche
parents: 521
diff changeset
  1040
     -->
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1041
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1042
	<p>The preceding example is very straightforward: there are containment triples
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1043
	whose subject is the container, whose predicate is  
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1044
	<code>ldp:contains</code>, and whose objects are the URIs of the contained resources,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1045
	and there is no distinction between member resources and contained resources. 
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1046
	A POST to this container will create a new resource
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1047
	and add it to the list of contained resources by adding a new containment triple
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1048
	to the container.  This type of container is called a
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1049
	<a title="">Linked Data Platform Basic Container</a>.  </p>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1050
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1051
	<p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1052
	Sometimes you have to build on existing models incrementally, so you have fewer degrees of
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1053
	freedom in the resource model.  In these situations, it can be useful to help clients map
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1054
	LDP patterns onto existing vocabularies, or to include members not created via the container; 
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1055
	<a title="Linked Data Platform Direct Container">LDP Direct Containers</a>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1056
	meet those kinds of needs.  Direct Containers allow membership triples to use a subject
373
0562f8c4d4d4 Cleanup of known cases where text assumed "normal" membership triple pattern, did not consider the flipped/MO cases
John Arwe
parents: 372
diff changeset
  1057
	other than the container itself as the consistent membership value, and/or to use
467
0eed67a3db4e Simplified some of the container examples
sspeiche
parents: 466
diff changeset
  1058
	a  predicate from an application's domain model as the membership predicate. Let's
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1059
	start with a pre-existing domain resource for a person's net worth, as illustrated below:</p>
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1060
			
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1061
<em>Request</em> to <code>http://example.org/netWorth/nw1</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1062
<pre class="example" id="ldpc-ex-membership-partial-req">GET /netWorth/nw1 HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1063
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1064
Accept: text/turtle</pre>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1065
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1066
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1067
<pre class="example" id="ldpc-ex-membership-partial">HTTP/1.1 200 OK
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1068
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1069
Date: Thu, 12 Jun 2014 18:26:59 GMT
653
71bc4ab13849 Fixed ETag headers to be strong and quoted
sspeiche
parents: 647
diff changeset
  1070
ETag: "0f6b5bd8dc1f754a1238a53b1da34f6b"
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1071
Link: &lt;http://www.w3.org/ns/ldp#RDFSource&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1072
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1073
Allow: GET,OPTIONS,HEAD,PUT,DELETE
646
d97c97e51f86 Updated examples in Prefer section to be in request/response format
sspeiche
parents: 644
diff changeset
  1074
Transfer-Encoding: chunked
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1075
<!-- @base <http://example.org/netWorth/nw1>. -->
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1076
@prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1077
@prefix o: &lt;http://example.org/ontology#&gt;.
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1078
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1079
&lt;http://example.org/netWorth/nw1&gt;
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1080
   a o:NetWorth;
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1081
   o:netWorthOf &lt;http://example.org/users/JohnZSmith&gt;;
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1082
   o:asset 
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1083
      &lt;assets/a1&gt;,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1084
      &lt;assets/a2&gt;;
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1085
   o:liability 
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1086
      &lt;liabilities/l1&gt;,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1087
      &lt;liabilities/l2&gt;,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1088
      &lt;liabilities/l3&gt;.
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1089
</pre>
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1090
	<p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1091
	In the preceding example, there is a <code>rdf:type</code> of <code>o:NetWorth</code> indicating the
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1092
	resource represents an instance of a person's net worth and a <code>o:netWorthOf</code> predicate indicating 
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1093
	the associated person.  There are two sets of same-subject, same-predicate triples; one for assets and
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1094
	one for liabilities.  Existing domain-specific applications exist that depend on those types and 
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1095
	predicates, so changing them <em>incompatibly</em> would be frowned upon.
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1096
	</p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1097
	
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1098
	<p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1099
	It would be helpful to be able to use LDP patterns to manage the assets and liabilities-related triples.
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1100
	Doing so using a Basic Container would require duplicating much of the information with different types and
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1101
	predicates, which would be onerous for large resources.  <a title="Linked Data Platform Direct Container">Direct Containers</a>
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1102
	provide a middle ground, by giving LDP clients a way to map existing domain-specific resources to LDP's
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1103
	types and interaction models.  
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1104
	In this specific example, 
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1105
	it would be helpful to be able to manage the assets and liabilities triples consistently, for example
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1106
	by using LDP containers.
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1107
	One way to do this is to create two containers, one to manage assets and another liabilities, 
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1108
	as separate HTTP resources.  Existing clients have no need to interact with those containers,
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1109
	whereas LDP-enabled clients now have container URLs that they can interact with.  The existing
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1110
	resource remains unchanged so that existing clients continue to function normally.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1111
	This is illustrated in the set of related examples, one example per HTTP resource, starting with
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1112
	the LDP-RS example from before:
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1113
	</p>
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1114
	
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1115
<em>Request</em> to <code>http://example.org/netWorth/nw1</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1116
<pre class="example" id="ldpc-ex-membership-full-req">GET /netWorth/nw1 HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1117
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1118
Accept: text/turtle</pre>
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1119
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1120
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1121
<pre class="example" id="ldpc-ex-membership-full">HTTP/1.1 200 OK
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1122
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1123
Date: Thu, 12 Jun 2014 18:26:59 GMT
653
71bc4ab13849 Fixed ETag headers to be strong and quoted
sspeiche
parents: 647
diff changeset
  1124
ETag: "0f6b5bd8dc1f754a1238a53b1da34f6b"
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1125
Link: &lt;http://www.w3.org/ns/ldp#RDFSource&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1126
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1127
Allow: GET,OPTIONS,HEAD,PUT,DELETE
646
d97c97e51f86 Updated examples in Prefer section to be in request/response format
sspeiche
parents: 644
diff changeset
  1128
Transfer-Encoding: chunked
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1129
<!-- @base <http://example.org/netWorth/nw1>. -->
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1130
@prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1131
@prefix o: &lt;http://example.org/ontology#&gt;.
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1132
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1133
&lt;http://example.org/netWorth/nw1&gt;
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1134
   a o:NetWorth;
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1135
   o:netWorthOf &lt;http://example.org/users/JohnZSmith&gt;;
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1136
   o:asset 
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1137
      &lt;assets/a1&gt;,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1138
      &lt;assets/a2&gt;;
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1139
   o:liability 
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1140
      &lt;liabilities/l1&gt;,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1141
      &lt;liabilities/l2&gt;,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1142
      &lt;liabilities/l3&gt;.
456
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1143
</pre>
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1144
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1145
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1146
	<p>The structure of the net worth resource is completely unchanged, so any existing 
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1147
	domain-specific applications continue to work without impact.
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1148
	LDP clients, on the other hand, have no way to understand that the asset and
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1149
	liability triples correspond in any way to LDP containers.  For that, they need the
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1150
	next two resources.
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1151
	</p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1152
	<p>The first container is a <a title="Linked Data Platform Direct Container">LDP Direct Container</a> to manage assets.  
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1153
	Direct Containers add the concept of <a title="Membership">membership</a>
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1154
	and flexibility on how to specify the <a title="Membership triples">membership triples</a>.
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1155
	</p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1156
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1157
<em>Request</em> to <code>http://example.org/netWorth/nw1/assets/</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1158
<pre class="example" id="ldpc-ex-membership-subj-req">GET /netWorth/nw1/assets/ HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1159
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1160
Accept: text/turtle</pre>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1161
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1162
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1163
<pre class="example" id="ldpc-ex-membership-subj">HTTP/1.1 200 OK
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1164
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1165
Date: Thu, 12 Jun 2014 18:26:59 GMT
653
71bc4ab13849 Fixed ETag headers to be strong and quoted
sspeiche
parents: 647
diff changeset
  1166
ETag: "6df36eef2631a1795bfe9ab76760ea75"
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1167
Accept-Post: text/turtle, application/ld+json
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1168
Allow: POST,GET,OPTIONS,HEAD
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1169
Link: &lt;http://www.w3.org/ns/ldp#DirectContainer&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1170
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
646
d97c97e51f86 Updated examples in Prefer section to be in request/response format
sspeiche
parents: 644
diff changeset
  1171
Transfer-Encoding: chunked
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1172
<!-- @base <http://example.org/netWorth/nw1/assets/>. -->      
456
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1173
@prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1174
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1175
@prefix o: &lt;http://example.org/ontology#&gt;.
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1176
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1177
&lt;http://example.org/netWorth/nw1/assets/&gt;
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1178
   a ldp:DirectContainer;
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1179
   dcterms:title "The assets of JohnZSmith";
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1180
   ldp:membershipResource &lt;http://example.org/netWorth/nw1&gt;;
488
6bc3c9a2b2f7 Adopted new predicate names: ldp:membershipResource, ldp:hasMemberRelation and ldp:isMemberOfRelation
sspeiche
parents: 487
diff changeset
  1181
   ldp:hasMemberRelation o:asset;
456
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1182
   ldp:contains &lt;a1&gt;, &lt;a2&gt;.
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1183
</pre>
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1184
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1185
	<p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1186
	In the preceding asset container, the consistent membership value 
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1187
	(<a title="Membership triples">membership-constant-URI</a>, still in the subject position) is not the
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1188
	container itself – it is the (separate) net worth resource. The
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1189
	membership predicate is <code>o:asset</code>,
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1190
	from the domain model. A POST of an asset representation to the asset container will create a new
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1191
	asset and add it to net-worth's list of	assets by adding a new membership triple
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1192
	to the resource and a containment triple to the container. 
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1193
	</p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1194
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1195
	<p>The second container is a <a title="Linked Data Platform Direct Container">LDP Direct Container</a> to manage liabilities.  
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1196
	</p>
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1197
<em>Request</em> to <code>http://example.org/netWorth/nw1/liabilities/</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1198
<pre class="example" id="ldpc-ex-membership-full-liabcont-req">GET /netWorth/nw1/liabilities/ HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1199
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1200
Accept: text/turtle</pre>
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1201
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1202
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1203
<pre class="example" id="ldpc-ex-membership-full-liabcont">HTTP/1.1 200 OK
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1204
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1205
Date: Thu, 12 Jun 2014 18:26:59 GMT
653
71bc4ab13849 Fixed ETag headers to be strong and quoted
sspeiche
parents: 647
diff changeset
  1206
ETag: "9f50da01f792281ddcfebe9788372d07"
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1207
Link: &lt;http://www.w3.org/ns/ldp#DirectContainer&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1208
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1209
Accept-Post: text/turtle, application/ld+json
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1210
Allow: POST,GET,OPTIONS,HEAD
646
d97c97e51f86 Updated examples in Prefer section to be in request/response format
sspeiche
parents: 644
diff changeset
  1211
Transfer-Encoding: chunked
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1212
<!-- @base <http://example.org/netWorth/nw1/liabilities/>. -->
456
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1213
@prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
6130538abdf0 ACTION-124 LDPR-RR as named graphs
sspeiche
parents: 454
diff changeset
  1214
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1215
@prefix o: &lt;http://example.org/ontology#&gt;.
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1216
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1217
&lt;http://example.org/netWorth/nw1/liabilities/&gt;
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1218
   a ldp:DirectContainer;
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1219
   dcterms:title "The liabilities of JohnZSmith";
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1220
   ldp:membershipResource &lt;http://example.org/netWorth/nw1&gt;;
488
6bc3c9a2b2f7 Adopted new predicate names: ldp:membershipResource, ldp:hasMemberRelation and ldp:isMemberOfRelation
sspeiche
parents: 487
diff changeset
  1221
   ldp:hasMemberRelation o:liability;
460
1f6e06fd7272 typo: added missing brackets in example 7
Arnaud Le Hors <lehors@us.ibm.com>
parents: 459
diff changeset
  1222
   ldp:contains &lt;l1&gt;, &lt;l2&gt;, &lt;l3&gt;.
87
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1223
</pre>
671fe85a872b Inserted examples 2&3, a more complete NetWorth resource
sspeiche
parents: 86
diff changeset
  1224
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1225
	<p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1226
	The preceding liability container is completely analogous to the asset container above, simply
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1227
	managing liabilities instead of assets and using the <code>o:liability</code> predicate.
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1228
	</p>
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1229
	<p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1230
	To add a another liability, a client would POST something like this to the liability container:
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1231
	</p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1232
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1233
<em>Request</em> to <code>http://example.org/netWorth/nw1/liabilities/</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1234
<pre class="example" id="ldpc-ex-membership-add-new-liability-req">POST /netWorth/nw1/liabilities/ HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1235
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1236
Accept: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1237
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1238
Content-Length: 63
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1239
<!-- @base is here only so it's easier to paste into validators for checking -->
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1240
@prefix o: &lt;http://example.org/ontology#&gt;.
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1241
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1242
&lt;&gt;
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1243
   a o:Liability.
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1244
   # plus any other properties that the domain says liabilities have
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1245
</pre>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1246
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1247
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1248
<pre class="example" id="ldpc-ex-membership-add-new-liability">HTTP/1.1 201 Created
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1249
Location: http://example.org/netWorth/nw1/liabilities/l4
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1250
Date: Thu, 12 Jun 2014 19:56:13 GMT
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1251
Link: &lt;http://www.w3.org/ns/ldp#DirectContainer&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1252
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1253
</pre>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1254
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1255
	<p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1256
	Assuming the server successfully processes this request and assigns the URI
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1257
	<code>&lt;http://example.org/netWorth/nw1/liabilities/l4&gt;</code> to the 
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1258
	newly created liability resource, at least two new triples would be added.
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1259
	</p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1260
	<ol>
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1261
	<li>In the net worth resource, <code>&lt;http://example.org/netWorth/nw1&gt; o:liability &lt;liabilities/l4&gt;</code></li>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1262
	<li>In the liability container, <code>&lt;http://example.org/netWorth/nw1/liabilities/&gt; ldp:contains &lt;l4&gt;</code>.</li>
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1263
	</ol>
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1264
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1265
	<p>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1266
	You might wonder why we chose to create two new containers instead of making
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1267
	<code>http://example.org/netWorth/nw1</code> itself a container.
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1268
	A single net worth container would be a fine design if <code>http://example.org/netWorth/nw1</code>
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1269
	had only assets or only liabilities (basically: only a single predicate to manage), 
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1270
	but since it has separate predicates for assets and liabilities an ambiguity arises:
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1271
	it is unspecified whether a client's creation request (POST)
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1272
	should add a new <code>o:asset</code> or <code>o:liability</code> triple. 
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1273
	Having separate <code>http://example.org/netWorth/nw1/assets/</code> 
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1274
	and <code>http://example.org/netWorth/nw1/liabilities/</code> containers
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1275
	allows both assets and liabilities to be created 
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1276
	and linked to the net-worth resource using the appropriate predicate.  Similar ambiguities arise
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1277
	if the client wishes to list the members and/or contained resources.
12
a3be44430b37 ISSUE-8 rename from LDBP to LDP and add remainder of open issues
sspeiche
parents:
diff changeset
  1278
	</p>
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1279
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1280
	<p>Continuing in the multiple containers direction, we will now extend our net worth example to add a container for
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1281
	advisors (people) that have managed the assets and liabilities.  We have decided
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1282
	to identify these advisors with URLs that contain a fragment (hash) to represent
462
3a7f9b05bad8 proofing through 454
John Arwe
parents: 461
diff changeset
  1283
	these real-world resources, not the documents that describe them.</p>
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1284
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1285
<em>Request</em> to <code>http://example.org/netWorth/nw1</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1286
<pre class="example" id="ldpc-ex-membership-full-elab-req">GET /netWorth/nw1 HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1287
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1288
Accept: text/turtle</pre>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1289
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1290
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1291
<pre class="example" id="ldpc-ex-membership-full-elab">HTTP/1.1 200 OK
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1292
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1293
Date: Thu, 12 Jun 2014 18:26:59 GMT
653
71bc4ab13849 Fixed ETag headers to be strong and quoted
sspeiche
parents: 647
diff changeset
  1294
ETag: "e8d129f45ca31848fb56213844a32b49"
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1295
Link: &lt;http://www.w3.org/ns/ldp#DirectContainer&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1296
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1297
Allow: GET,OPTIONS,HEAD,PUT,DELETE
646
d97c97e51f86 Updated examples in Prefer section to be in request/response format
sspeiche
parents: 644
diff changeset
  1298
Transfer-Encoding: chunked
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1299
<!-- @base <http://example.org/netWorth/nw1>. -->
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1300
@prefix ldp: &lt;http://www.w3.org/ns/ldp#&gt;.
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1301
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
486
974b4886835b change all unicode 00A0 (non-breaking space) to blank (0020)
John Arwe
parents: 485
diff changeset
  1302
@prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt;.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1303
@prefix o: &lt;http://example.org/ontology#&gt;.
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1304
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1305
&lt;http://example.org/netWorth/nw1&gt;
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1306
   a o:NetWorth;
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1307
   o:netWorthOf &lt;http://example.org/users/JohnZSmith&gt;;
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1308
   o:advisor
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1309
   	 &lt;advisors/bob#me&gt;,     # URI of a person
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1310
   	 &lt;advisors/marsha#me&gt;.
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1311
   	 
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1312
&lt;advisors/&gt;
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1313
   a ldp:IndirectContainer;
465
26eb1d6d4fd6 fixing things found proofing SS updates and a few of Arnaud's email comments
John Arwe
parents: 464
diff changeset
  1314
   dcterms:title "The asset advisors of JohnZSmith";
488
6bc3c9a2b2f7 Adopted new predicate names: ldp:membershipResource, ldp:hasMemberRelation and ldp:isMemberOfRelation
sspeiche
parents: 487
diff changeset
  1315
   ldp:membershipResource &lt;&gt;;
6bc3c9a2b2f7 Adopted new predicate names: ldp:membershipResource, ldp:hasMemberRelation and ldp:isMemberOfRelation
sspeiche
parents: 487
diff changeset
  1316
   ldp:hasMemberRelation o:advisor;
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1317
   ldp:insertedContentRelation foaf:primaryTopic;
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1318
   ldp:contains
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1319
   	 &lt;bob&gt;,     # URI of a document a.k.a. an information resource
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1320
   	 &lt;marsha&gt;.  # describing a person
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1321
</pre>	
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1322
	
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1323
	<p>To handle this type of indirection, the triple with predicate of <code>ldp:insertedContentRelation</code> and object of 
468
f960af656afb Simplified some of the container examples
sspeiche
parents: 467
diff changeset
  1324
	<code>foaf:primaryTopic</code> informs clients that when POSTing to this container, they need to include a triple of the
462
3a7f9b05bad8 proofing through 454
John Arwe
parents: 461
diff changeset
  1325
	form <code>(&lt;&gt;, foaf:primaryTopic, topic-URI)</code> to inform the server which URI to use 
3a7f9b05bad8 proofing through 454
John Arwe
parents: 461
diff changeset
  1326
	(<code>topic-URI</code>) in the new membership triple.</p>
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1327
	
563
4e61db8dbfa2 Update narrative on net worth example (#s 2-5, section 5.1, at time of writing)
John Arwe
parents: 562
diff changeset
  1328
	<p>This type of container is referred to as a <a title="Linked Data Platform Indirect Container">LDP Indirect Container</a>. 
514
7e329a35960e A vs an fun
sspeiche
parents: 513
diff changeset
  1329
	It is similar to an <a title="Linked Data Platform Direct Container">LDP Direct Container</a> 
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1330
	but it provides an indirection to add (via a create request) as a member any resource, 
566
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1331
	including a URI representing a real-world object.  Create requests to 
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1332
	<a title="Linked Data Platform Direct Container">LDP Direct Containers</a> 
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1333
	can only add information resources [[WEBARCH]] - the documents they create - as members.
cfc0c8b396a8 fix typos
John Arwe
parents: 565
diff changeset
  1334
	</p>
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1335
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1336
	<p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1337
	To add a another advisor, a client would POST something like this to the advisors container:
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1338
	</p>
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1339
<em>Request</em> to <code>http://example.org/netWorth/nw1/advisors/</code>:
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1340
<pre class="example" id="ldpc-ex-membership-add-new-advisor">POST /netWorth/nw1/advisors/ HTTP/1.1
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1341
Host: example.org
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1342
Accept: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1343
Content-Type: text/turtle
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1344
Slug: george
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1345
Content-Length: 72
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1346
<!-- @base <http://example.org/netWorth/nw1/advisors/george>. -->
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1347
@prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt;.
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1348
@prefix o: &lt;http://example.org/ontology#&gt;.
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1349
&lt;&gt;
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1350
   a o:Advisor;
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1351
   foaf:primaryTopic &lt;#me&gt;.
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1352
   # plus any other properties that the domain says advisors have
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1353
</pre>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1354
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1355
<em>Response:</em>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1356
<pre class="example" id="ldpc-ex-membership-add-new-advisor">HTTP/1.1 201 Created
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1357
Location: http://example.org/netWorth/nw1/advisors/george
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1358
Date: Thu, 12 Jun 2014 19:56:13 GMT
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1359
Link: &lt;http://www.w3.org/ns/ldp#RDFSource&gt;; rel="type",
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1360
      &lt;http://www.w3.org/ns/ldp#Resource&gt;; rel="type"
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1361
</pre>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1362
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1363
	<p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1364
	Assuming the server successfully processes this request and assigns the URI
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1365
	<code>&lt;http://example.org/netWorth/nw1/advisors/george&gt;</code> to the 
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1366
	newly created advisor resource, at least two new triples would be added.
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1367
	</p>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1368
	<ol>
644
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1369
	<li>In the net worth resource, <code>&lt;http://example.org/netWorth/nw1&gt; o:advisor &lt;advisors/george#me&gt;</code></li>
afe041e0f7fc Updated examples in container sections to be in request/response format
sspeiche
parents: 637
diff changeset
  1370
	<li>In the advisors container, <code>&lt;http://example.org/netWorth/nw1/advisors/&gt; ldp:contains &lt;george&gt;</code></li>
564
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1371
	</ol>
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1372
cba76c3813b9 More example revisions, and fix bug in advisors example
John Arwe
parents: 563
diff changeset
  1373
	<p>In summary, <a href="#fig-ldpc-types"></a> illustrates the LDP-defined container types: Basic, Direct, and Indirect, along
491
16d872a712b6 Adopted container hierarchy and merged Indirect Container into Container
sspeiche
parents: 489
diff changeset
  1374
	with their class relationship to types of LDPRs.</p>
450
e8d84dbc86dc ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 449
diff changeset
  1375
	
e8d84dbc86dc ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 449
diff changeset
  1376
	 <figure id="fig-ldpc-types">
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1377
        <img src="images/ldpc-hierarchy.png" alt="Types of Linked Data Platform Containers" />
491
16d872a712b6 Adopted container hierarchy and merged Indirect Container into Container
sspeiche
parents: 489
diff changeset
  1378
        <figcaption>Class relationship of types of Linked Data Platform Containers</figcaption>
450
e8d84dbc86dc ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 449
diff changeset
  1379
    </figure>
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1380
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1381
	<p>The following table illustrates some differences between <a title="membership">membership</a> and 
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1382
	<a title="containment">containment</a> triples.  For details on the normative behavior, see appropriate sections
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1383
	below.
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1384
	</p>
527
b86124412c7a html5 validation fixes
sspeiche
parents: 525
diff changeset
  1385
	<table style="border: 1px solid gray" id="ldpc-mbrcntdiff">
554
5a4fe2b38a2a rename empty container triples to minimal container triples
John Arwe
parents: 553
diff changeset
  1386
		<thead><tr><th rowspan="2">Completed Request</th><th style="background:#FFFFFF;" colspan="2">Effects</th></tr>
479
c116a0ec33d8 Resolved a few editoral TODO's
John Arwe
parents: 477
diff changeset
  1387
		       <tr class="oddrow"><th>Membership</th><th>Containment</th></tr></thead>
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1388
		<tr><td>LDPR created in LDP-BC</td><td>New triple: (LDPC, ldp:contains, LDPR)</td><td>Same</td></tr>
489
a33c03215d88 Adopted new resource types: LDP RDF Source (LDP-RS) (was LDP RDF Resource) and LDP Non-RDF Source (LDP-NR) (was LDP Binary Resource)
sspeiche
parents: 488
diff changeset
  1389
		<tr><td>LDPR created in LDP-DC</td><td>New triple links LDP-RS to created LDPR. LDP-RS URI may be same as LDP-DC</td>
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1390
			<td>New triple: (LDPC, ldp:contains, LDPR)</td></tr>
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1391
		<tr><td>LDPR created in LDP-IC</td><td>New triple links LDP-RS to content indicated URI</td>
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1392
			<td>New triple: (LDPC, ldp:contains, LDPR)</td></tr>
506
c828dbebaebb Split out different kinds of LDPCs into their own subsection
sspeiche
parents: 505
diff changeset
  1393
		<tr><td>LDPR is deleted</td><td>Membership triple may be removed</td><td>(LDPC, ldp:contains, LDPR) triple is removed
449
623bbfdea989 ACTION-120 (Part 1) Added concepts of containers (basic, direct and indirect)
sspeiche
parents: 448
diff changeset
  1394
			</td></tr>
452
c4b538b7e57f ACTION-120 (Part 2) Added concepts of containers (basic, direct and indirect) to LDPC intro
sspeiche
parents: 451
diff changeset
  1395
		<tr><td>LDPC is deleted</td><td>Triples and member re