RE: Draft Protocol question -- Creating a child basic container for annotations

Thanks, Rob.  I overlooked the bit in LDP spec about specifying interaction models – still learning LDP terminology. 

 

And agreeing with you I do not see the need to put anything in the Annotation Protocol  document, especially since it is documented in the LDP spec itself.  But this example contributes to the idea that we might need guidelines or a primer or a cookbook or something to supplement the Annotation Protocol specification itself.

 

-Tim Cole

 

From: Robert Sanderson [mailto:azaroth42@gmail.com] 
Sent: Tuesday, June 02, 2015 5:53 PM
To: t-cole3
Cc: Web Annotation
Subject: Re: Draft Protocol question -- Creating a child basic container for annotations

 

 

Hi Tim,

 

That's correct. You would have the interaction model specified in the POST, via the Link header.  The actual specification documentation is 5.2.3.4 in LDP.

 

As to the protocol doc, I don't know if we need to re-specify that, rather than the annotation specific interactions.  Or, in other words, I think the scope of the document is limited to managing annotations in containers, and we can assume that the containers already exist.  Open to arguments to the contrary, if we think that management of the containers is something we need to specify as well.

 

Rob

 

 

On Tue, Jun 2, 2015 at 3:25 PM, Timothy Cole <t-cole3@illinois.edu <mailto:t-cole3@illinois.edu> > wrote:

The LDP 1.0 Primer (http://www.w3.org/TR/ldp-primer/ <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_TR_ldp-2Dprimer_&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=haO0nb0tnSgrfSEEdN13SXaSerW_tdeyrA-qsX_FtTQ&e=> , Editor’s draft dated today) gives an example of how to create a new basic container inside an existing basic container (modified from example 6 in section 2.3):

 

In Turtle and assuming the parent container is http://example.org/containerA/ <https://urldefense.proofpoint.com/v2/url?u=http-3A__example.org_containerA_&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=vUQmpjaZZtTRer9kxF1skcMSSmgjAvoSU2ejnarExis&e=> 

 

POST containerA/ HTTP/1.1

Host: example.org <https://urldefense.proofpoint.com/v2/url?u=http-3A__example.org&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=qZbPX_gfINN7B3jDY7NDzv1Zb1mvTI6WcIKKXioYDIs&e=> 

Content-Type: text/turtle

Link: <http://www.w3.org/ns/ldp/BasicContainer <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_ns_ldp_BasicContainer&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=Z48pWcLr0lpUKoZ5ujNqsAZ2pB6_PM5Sc4awNVlgxEU&e=> >; rel="type"

Slug: timsAnnos

 

@prefix ldp: <http://www.w3.org/ns/ldp# <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_ns_ldp-23&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=ry82_w2HnOf1KSLohmjBBx96deDVha4CmnxBh3vL97s&e=> > .

@prefix dcterms: <http://purl.org/dc/terms/ <https://urldefense.proofpoint.com/v2/url?u=http-3A__purl.org_dc_terms_&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=lHfedQPT_0QKdJ1Yu3UAjsuxP-9j0J0U3IvXw5DtzXw&e=> > .

<> a ldp:Container, ldp:BasicContainer;

   dcterms:title "Tim’s Annotations" ; 

   dcterms:description "This container will contain Annotations created by Tim." .  

 

This should result in a new child basic container, http://example.org/containerA/timsAnnos/ <https://urldefense.proofpoint.com/v2/url?u=http-3A__example.org_containerA_timsAnnos_&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=PDsQjVanjsSX5BKwco_0gPxD18jtvkVFWawOxMUVWVk&e=> 

 

The key, according to the text accompanying the original example in the Primer is the inclusion of the Link: <http://www.w3.org/ns/ldp/BasicContainer <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_ns_ldp_BasicContainer&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=Z48pWcLr0lpUKoZ5ujNqsAZ2pB6_PM5Sc4awNVlgxEU&e=> >; rel="type" header.  Following this logic, if I want to make sure that the new container is understood by the LDP Server to be a container for annotations, should I also include an additional link in the Post request Link header? i.e.:

 

POST containerA/ HTTP/1.1

Host: example.org <https://urldefense.proofpoint.com/v2/url?u=http-3A__example.org&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=qZbPX_gfINN7B3jDY7NDzv1Zb1mvTI6WcIKKXioYDIs&e=> 

Content-Type: text/turtle

Link: <http://www.w3.org/ns/ldp/BasicContainer <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_ns_ldp_BasicContainer&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=Z48pWcLr0lpUKoZ5ujNqsAZ2pB6_PM5Sc4awNVlgxEU&e=> >; rel="type", 

          <http://www.w3.org/TR/annotation-protocol/constraints <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_TR_annotation-2Dprotocol_constraints&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=AJpVFuEX9fYwOTwjzV93sAqp0XWdyyxZZRFSZjXyJwA&e=> >; rel="http://www.w3.org/ns/ldp#constrainedBy <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_ns_ldp-23constrainedBy&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=zG6epQ4O2p5Tt5706GdbiazQTZI1yXtKmVT-hBdh0go&e=> "

Slug: timsAnnos

 

@prefix ldp: <http://www.w3.org/ns/ldp# <https://urldefense.proofpoint.com/v2/url?u=http-3A__www.w3.org_ns_ldp-23&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=ry82_w2HnOf1KSLohmjBBx96deDVha4CmnxBh3vL97s&e=> > .

@prefix dcterms: <http://purl.org/dc/terms/ <https://urldefense.proofpoint.com/v2/url?u=http-3A__purl.org_dc_terms_&d=AwMFaQ&c=8hUWFZcy2Z-Za5rBPlktOQ&r=zjI0r-H6xRs5fYf2_jJkju6US9ijk0nLw4ns2nuwU2k&m=mQMH_CuPfDbeUChNMszS_n-R9GESvuQ68ZGrAAQujyU&s=lHfedQPT_0QKdJ1Yu3UAjsuxP-9j0J0U3IvXw5DtzXw&e=> > .

<> a ldp:Container, ldp:BasicContainer;

   dcterms:title "Tim’s Annotations" ; 

   dcterms:description "This container will contain Annotations created by Tim." .  

 

Apologies if this is dealt with somewhere in the Protocol draft and I missed it.

 

Thanks,

 

Tim  Cole  





 

-- 

Rob Sanderson

Information Standards Advocate

Digital Library Systems and Services

Stanford, CA 94305