W3C home > Mailing lists > Public > public-linked-json@w3.org > July 2013

Syntax doc edits to avoid implying that JSON-LD is not RDF

From: David Booth <david@dbooth.org>
Date: Sun, 28 Jul 2013 18:16:28 -0400
Message-ID: <51F5983C.9010301@dbooth.org>
To: Gregg Kellogg <gregg@greggkellogg.com>, Markus Lanthaler <markus.lanthaler@gmx.net>, David Longley <dlongley@digitalbazaar.com>, Manu Sporny <msporny@digitalbazaar.com>, Niklas Lindström <lindstream@gmail.com>
CC: Linked JSON <public-linked-json@w3.org>
Attached are the corresponding changes that I see that are needed in the 
syntax document:
http://json-ld.org/spec/latest/json-ld/

Again, three documents are attached:

  - json-ld-index.html.old: A snapshot of the Syntax document as it was 
before I made the attached edits, to provide a basis for diffs.

  - json-ld-index2.html: The Syntax document containing my suggested 
changes.

  - json-ld-index2-diffs.txt: Diffs between the above files.

Other editorial issues that I noticed but I did not fix in the attached 
version:

1. The Abstract begins: "JSON is a useful data serialization and 
messaging format".  Delete "useful" or perhaps delete the whole 
sentence.  (Other data serialization and messaging formats are *not* 
useful?)

2. The Features at Risk section needs to be updated regarding blank 
nodes as predicates.

Let me know if you have questions.

Thanks!
David

On 07/28/2013 03:20 PM, David Booth wrote:
> As promised, attached are suggested edits to the "JSON-LD 1.0 Processing
> Algorithms and API" document at
> http://json-ld.org/spec/latest/json-ld-api/index.html
> The purpose of these edits is to avoid implying that JSON-LD is not RDF.
>   The main strategy was to change phrases like "transforms JSON-LD to
> RDF" and "converts RDF to JSON-LD" to phrases like "deserializes JSON-LD
> to RDF" and "serializes RDF to JSON-LD".
>
> Note that some of the section titles changed as a result, and two HTML
> anchors were also changed:
>
>    convert-to-rdf-algorithm --> deserialize-to-rdf-algorithm
>
>    convert-from-rdf-algorithm --> serialize-from-rdf-algorithm
>
> Therefore other documents that reference this document may need to be
> updated correspondingly.
>
> Three files are attached:
>
>   - json-ld-api-index.html.old: This is a snapshot of the original file,
> before I made any changes.  I made this snapshot in case someone else
> was also editing the file at the same time, so it provides a clean basis
> for a "diff" comparison.
>
>   - json-ld-api-index2.html: The new version in which I made edits to
> avoid implying that JSON-LD is not RDF.   I also corrected a few
> unrelated typos that I noticed along the way, I removed the obsolete
> mention of RDF disallowing blank node named graphs (since they are now
> allowed), and I added text on suggested work-arounds for users that want
> to retain the information contained in triples that have blank node
> predicates.
>
>   - json-ld-api-index2-diffs.txt: Diffs between the above two files.
>
> Let me know if you have questions.
>
> Thanks!
> David
>

Received on Sunday, 28 July 2013 22:17:14 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:18:38 UTC