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

That's a particularly easy point to overlook -- it's rather buried in the
bullets.

I've added a note to the effect that container management is not in scope
for the annotation protocol, with a reference to the LDP spec.

[Yes, I'm working on the protocol doc!]

Rob

On Wed, Jun 3, 2015 at 7:19 AM, Timothy Cole <t-cole3@illinois.edu> wrote:

> 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> 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
>



-- 
Rob Sanderson
Information Standards Advocate
Digital Library Systems and Services
Stanford, CA 94305