solid / solid/data-interoperability-panel

ldp:contains doesn't necessarly point to the focus node of Data Instance

Open
#168 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

data-registration
Dominant language
Bikeshed
Stars
58
Forks
18
PR merge metrics
No merged PRs in 30d

Description

In 5.2. Data Registration we find

Each Data Instance is linked via the ldp:contains property.

In cases where IRI denoting Data Instance has # fragment, ldp:contains will just link to the resource without the fragment.

I understand that we want to rely on the server to manage containment tripes. In that case we probably need to clarify that ldp:cotains links to the resource describing data instance and explain how do find focus node of that resource.

I'm going to update snippets in the primer and instead of having

alice-pro:773605f0-b5bf-4d46-878d-5c167eac8b5d
  a interop:DataRegistration ;
  # [...]
  interop:registeredShapeTree solidtrees:Project ;
  ldp:contains
    alice-pro:ccbd77ae-f769-4e07-b41f-5136501e13e7\#project ,
    alice-pro:7a130c38-668a-4775-821a-08b38f2306fb\#project .

have it without fragments

alice-pro:773605f0-b5bf-4d46-878d-5c167eac8b5d
  a interop:DataRegistration ;
  # [...]
  interop:registeredShapeTree solidtrees:Project ;
  ldp:contains
    alice-pro:ccbd77ae-f769-4e07-b41f-5136501e13e7 ,
    alice-pro:7a130c38-668a-4775-821a-08b38f2306fb .

Once I do that I will see where sai-js code breaks and where do we need to map resources to their focus nodes.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with section 5.2, Data Registration, and the primer snippets described in the issue. Review how ldp:contains is explained when a Data Instance IRI has a fragment, update the examples to use resource IRIs without fragments, and clarify how to find the resource's focus node; then check where the sai-js code may depend on the old form.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.