[poe] Issue: Definition of relations (model) marked as Editorial

riannella has just labeled an issue for https://github.com/w3c/poe as "Editorial":

== 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?)


See https://github.com/w3c/poe/issues/135

Received on Friday, 21 April 2017 02:00:53 UTC