Skip to content

Commit a81cacb

Browse files
committed
Editorial fixes based on Sandro's review
See: http://lists.w3.org/Archives/Public/public-rdf-wg/2013Mar/0298.html This addresses #224.
1 parent 3382fd9 commit a81cacb

File tree

2 files changed

+9
-10
lines changed

2 files changed

+9
-10
lines changed

spec/latest/json-ld/index.html

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -450,7 +450,7 @@ <h1>Basic Concepts</h1>
450450
<section class="informative">
451451
<h2>The Context</h2>
452452

453-
<p>Simply speaking, a <tdef>context</tdef> is used to map <tref title="term">terms</tref>, to
453+
<p>Simply speaking, a <tdef>context</tdef> is used to map <tref title="term">terms</tref> to
454454
<tref title="IRI">IRIs</tref>. <tref title="term">Terms</tref> are case sensitive
455455
and any valid <tref>string</tref> that is not a reserved JSON-LD <tref>keyword</tref>
456456
can be used as a <tref>term</tref>.</p>
@@ -841,7 +841,7 @@ <h2>Default Vocabulary</h2>
841841

842842
<p>At times, all properties and types may come from the same vocabulary. JSON-LD's
843843
<code>@vocab</code> keyword allows an author to set a common prefix to be used
844-
for all properties and types that do not match a <tref>term</tref> or are neither
844+
for all properties and types that do not match a <tref>term</tref> and are neither
845845
a <tref>compact IRI</tref> nor an <tref>absolute IRI</tref> (i.e., they do
846846
not contain a colon).</p>
847847

@@ -1410,7 +1410,7 @@ <h2>Advanced Context Usage</h2>
14101410
<tref title="keyword">JSON-LD 1.0 keywords</tref> are treated as any other term, i.e.,
14111411
they are ignored unless mapped to an <tref>IRI</tref>. Furthermore, the use of
14121412
empty <tref title="term">terms</tref> (<code>""</code>) is not allowed as
1413-
not all programming languages are able to handle empty property names.</p>
1413+
not all programming languages are able to handle empty JSON keys.</p>
14141414
</section>
14151415

14161416
<section class="normative">
@@ -2653,8 +2653,7 @@ <h2>Embedding JSON-LD in HTML Documents</h2>
26532653
<p>If JSON-LD content is extracted as RDF [[RDF11-CONCEPTS]], it should be expanded into an
26542654
<tref href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-dataset">RDF dataset</tref> using the
26552655
<cite><a href="../json-ld-api/#convert-to-rdf-algorithm">Convert to RDF Algorithm</a></cite>
2656-
[[JSON-LD-API]]. If multiple embedded JSON-LD documents are extracted as RDF,
2657-
the result is the RDF merge of the extracted datasets.</p>
2656+
[[JSON-LD-API]].</p>
26582657
</section>
26592658

26602659
</section>
@@ -2674,12 +2673,12 @@ <h1>Data Model</h1>
26742673
<li>The <tref>default graph</tref> does not have a name and MAY be empty.</li>
26752674
<li>Each <tref>named graph</tref> is a pair consisting of an <tref>IRI</tref> or
26762675
<tref>blank node identifier</tref> (the <tdef>graph name</tdef>) and a <tref>JSON-LD graph</tref>.
2677-
Whenever possible, the <tref>graph name</tref> SHOULD be an <tref>IRI</tref>.</li>
2676+
Whenever practical, the <tref>graph name</tref> SHOULD be an <tref>IRI</tref>.</li>
26782677
<li>A <tdef>JSON-LD graph</tdef> is a labeled directed graph, i.e., a set of
26792678
<tref title="node">nodes</tref> connected by <tref title="edge">edges</tref>.</li>
26802679
<li>Every <tdef>edge</tdef> has a direction associated with it and is labeled with
26812680
an <tref>IRI</tref> or a <tref>blank node identifier</tref>. Within the JSON-LD syntax
2682-
these edge labels are called <tdef title="property">properties</tdef>. Whenever possible, an
2681+
these edge labels are called <tdef title="property">properties</tdef>. Whenever practical, an
26832682
<tref>edge</tref> SHOULD be labeled with an <tref>IRI</tref>.</li>
26842683
<li>Every <tdef>node</tdef> is an <tref>IRI</tref>, a <tref>blank node</tref>,
26852684
a <tref>JSON-LD value</tref>, or a <tref>list</tref>.</li>
@@ -2741,7 +2740,7 @@ <h1>JSON-LD Grammar</h1>
27412740
in [[!RFC4627]].</p>
27422741

27432742
<p>A <tref>JSON-LD document</tref> MUST be a single <tref>node object</tref>
2744-
or a JSON <tref>array</tref> containing a set of one or more
2743+
or an <tref>array</tref> whose elements are each
27452744
<tref title="node object">node objects</tref> at the top level.</p>
27462745

27472746
<p>In contrast to JSON, in JSON-LD the keys in <tref title="JSON object">objects</tref>
@@ -2769,7 +2768,7 @@ <h2>Terms</h2>
27692768
with an <code>@</code> character as future versions of JSON-LD may introduce
27702769
additional <tref title="keyword">keywords</tref>. Furthermore, the term MUST NOT
27712770
be an empty <tref>string</tref> (<code>""</code>) as not all programming languages
2772-
are able to handle empty property names.</p>
2771+
are able to handle empty JSON keys.</p>
27732772

27742773
<p>See <a class="sectionRef" href="#the-context"></a> and
27752774
<a class="sectionRef" href="#iris"></a> for further discussion
@@ -2797,7 +2796,7 @@ <h2>Node Objects</h2>
27972796
a <tref>JSON-LD graph</tref> may be spread among different
27982797
<tref title="node object">node objects</tref> within a document. When
27992798
that happens, the keys of the different
2800-
<tref title="node object">node objects</tref> are merged to create the
2799+
<tref title="node object">node objects</tref> need to be merged to create the
28012800
properties of the resulting <tref>node</tref>.</p>
28022801

28032802
<p>A <tref>node object</tref> MUST be a <tref>JSON object</tref>. All keys
-812 Bytes
Loading

0 commit comments

Comments
 (0)