[poe] Definition of relations (model)

iherman has just created a new issue for https://github.com/w3c/poe:

== Definition of relations (model) ==
3.2.1 defines relations. It refers to an `Entity` (whatever that means), but the text is not very clear how that is used. It also says

> The default value for the relation attribute is target which indicates

which is again unclear; because `value` is often used to denote the "object" in RDF (or as part of a key-value pair in JSON), one would expect to use something like

```json
   {
     "relation" : "target"
   }
```

but that is clearly wrong.

The vocab document makes it clearer. "relation" is a property, but it is "abstract", ie, it is used in ODRL via its subproperties. "target" is one of those, "output" is another.

This is an example where the model document, by itself, confusing, and needs re-write. Make the subproperty feature explicit in the model.

(I believe the usage of the term "Entity" is the main reason for the confusion. A UML term creeping in?)


Please view or discuss this issue at https://github.com/w3c/poe/issues/135 using your GitHub account

Received on Wednesday, 19 April 2017 13:07:32 UTC