w3c / json-ld-syntax

JSON-LD 1.1 Specification
https://w3c.github.io/json-ld-syntax/
Other
114 stars 22 forks source link

clarify that `@none @id` are blank nodes, swap Examples 104 and 105 #397

Open VladimirAlexiev opened 2 years ago

VladimirAlexiev commented 2 years ago

I suggest the following editorial changes:

VladimirAlexiev commented 2 years ago

A similar edit could be done to Examples 107 and 108 https://w3c.github.io/json-ld-syntax/#example-indexing-data-in-json-ld-by-type-with-set-representation. In such case the code in Example 108 https://w3c.github.io/json-ld-syntax/#example-indexing-data-in-json-ld-by-type-using-none could be changed to eg

    "none": [{
      "@id": "https://greggkellogg.net/",
      "name": "Gregg Kellogg"
    }, {
      "@id": "http://champin.net/",
      "name": "Pierre-Antoine Champin"
    }]
VladimirAlexiev commented 2 years ago

In the same train of thought: Example 122 https://w3c.github.io/json-ld-syntax/#example-referencing-named-graphs-using-an-id-map-with-none shows precisely two anonymous (blank node) graphs.

So I think the note above it is misleading because no graphs are merged (check in the Expanded and TriX tabs):

Note, however, that if multiple graphs are represented without an @id, they will be merged on expansion. To prevent this, use @none judiciously, and consider giving graphs their own distinct identifier.

Suggest to change it to:

But using anonymous graphs is not recommended because it could lead to confusion. So use @none judiciously, and consider giving graphs their own distinct identifier.