Re: [poe] Editorial: the formatting of the examples is not consistent (model)

• From: Ivan Herman via GitHub <sysbot+gh@w3.org>
• Date: Fri, 21 Apr 2017 07:57:36 +0000
• To: public-poe-archives@w3.org
• Message-ID: <issue_comment.created-296115837-1492761454-sysbot+gh@w3.org>

It is, mainly, inconsistent. B.t.w., there is nothing JSON-LD specific, it is simply JSON.

In Example 1:

```json
{
"@context": {
    "odrl": "http://www.w3.org/ns/odrl/2/"
    },
    "@type": "odrl:Set",
    ...
}
```

In Example 3:

```json
{
    "@context": {
    "odrl": "http://www.w3.org/ns/odrl/2/"
    },
    "@type": "odrl:Agreement",
    "@id": "http://example.com/policy:8888",
    ...
}
```

In Example 18:

```json
{
    "@context": [{ "odrl": "http://www.w3.org/ns/odrl/2/",
                   "vCard": "http://www.w3.org/2006/vcard/ns#" }],
    "@type": "odrl:Agreement",
    "@id": "http://example.com/policy:8888",
    "permission": [{
        "target": "http://example.com/music/1999.mp3",
        "assigner":
    ...
}
```

I would simply prefer a standard JSON style. Ie,

```json
{
    "@context": {
        "odrl": "http://www.w3.org/ns/odrl/2/"
    },
    "@type": "odrl:Agreement",
    "@id": "http://example.com/policy:8888",
    ...
}

```

and

```json
{
    "@context": {
        "odrl": "http://www.w3.org/ns/odrl/2/",
        "vCard": "http://www.w3.org/2006/vcard/ns#"
    },
    "@type": "odrl:Agreement",
    "@id": "http://example.com/policy:8888",
    "permission": [{
        "target": "http://example.com/music/1999.mp3",
        "assigner":
   ...
```

(Note, b.t.w., that the current JSON-LD for Example 18 is probably wrong, the context is a single object in all our examples.)

I guess the safe thing is to use a JSON beautifier on all the examples to ensure a unified style.


-- 
GitHub Notification of comment by iherman
Please view or discuss this issue at https://github.com/w3c/poe/issues/137#issuecomment-296115837 using your GitHub account

Received on Friday, 21 April 2017 07:57:42 UTC