Skip to content

Commit 34e73c5

Browse files
gkellogghartig
andcommitted
Apply suggestions from code review
Suggestions from @hartig. Co-authored-by: Olaf Hartig <[email protected]>
1 parent 00507e9 commit 34e73c5

File tree

1 file changed

+14
-15
lines changed

1 file changed

+14
-15
lines changed

spec/index.html

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -547,20 +547,19 @@ <h3>RDF Version Announcement</h3>
547547

548548
<pre class="box http">GET /document.ttl HTTP/1.1
549549
Host: example.com
550-
Accept: text/turtle; version="1.2"
550+
Accept: text/turtle; version=1.2
551551
</pre>
552552
<p>
553553
Section <a href="#defined-version-labels" class="sectionRef"></a> defines <a>version labels</a>
554554
to be used with the <code>version</code> parameter and in <a>concrete RDF syntax</a>.
555555
</p>
556556

557557
<p class="note">As HTTP <a data-cite="webarch#frag-coneg">content negotiation</a> is advisory,
558-
clients recieving a document should be prepared to properly handle a document
558+
clients receiving a document should be prepared to properly handle a document
559559
of the requested media type but potentially having a `version` other than what was
560560
requested.
561-
Systems may consider down-grading the content to an appropriate version
562-
as discussed in <a href="#defined-version-labels" class="sectionRef"></a>,
563-
or by returning a `406 "Not Acceptable"` status in the response.</p>
561+
Clients may consider down-grading the content to an appropriate version themselves
562+
as discussed in <a href="#server-considerations" class="sectionRef"></a>.</p>
564563
</section>
565564
</section>
566565

@@ -625,35 +624,35 @@ <h3>Version Labels</h3>
625624
</tbody>
626625
</table>
627626

628-
<p>For serializations supporting in-line version annouoncement,
627+
<p>For serializations supporting in-line version announcement,
629628
the version announcement SHOULD be made early in the document
630629
and certainly before serializing any feature depending on that version.</p>
631630

632631
<section id="server-considerations" class="informative">
633-
<h4>Server considerations</h4>
632+
<h4>Server Considerations</h4>
634633
<p>When serializing a graph or dataset which uses features incompatible
635634
with a requested version, servers can consider different alternatives:</p>
636635

637636
<ol>
638-
<li>Downgrade <a>Triple Terms</a> by using an algorithm such
639-
as <em>Unstar</em> ("1.2" to "1.2-basic" or "1.1").
637+
<li>Eliminate <a>triple terms</a> by using an algorithm such
638+
as <em>Unstar</em> (downgrading from version "1.2" to "1.2-basic" or to "1.1").
640639
<div class="ednote">Fix this when such an algorithmm is defined.</div></li>
641-
<li>Downgrade <a>directional language-tagged strings</a>
642-
to a <a>literal</a> with a <a>datatype IRI</a>,
643-
using <a data-cite="JSON-LD11#the-i18n-namespace">the `i18n` namespace</a>, as defined in [[JSON-LD11]]
640+
<li>Replace <a>directional language-tagged strings</a>
641+
by <a>literals</a> with a <a>datatype IRI</a> that
642+
uses the <a data-cite="JSON-LD11#the-i18n-namespace">`i18n` namespace</a>, as defined in [[JSON-LD11]]
644643
("1.2" or "1.2-basic" to "1.1").</li>
645644
<li>Return `406 "Not Acceptable"`.</li>
646645
<li>Ignore the requested version and return a native representation.</li>
647646
</ol>
648647

649-
<p class="note">The principle here is to follow the
648+
<p class="note">The suggestion here is to follow the
650649
<a href="https://en.wikipedia.org/wiki/Robustness_principle">Robustness principle</a>
651650
(also known as Postel's Law):
652651
servers should be conservative in what they send, be liberal in what they accept.</p>
653652
</section>
654653

655654
<section id="client-considerations" class="informative">
656-
<h4>Client considerations</h4>
655+
<h4>Client Considerations</h4>
657656
<p>If a document has no stated `version` (either by HTTP header or internal),
658657
systems can assume the version is `"1.2"`, which is compatible
659658
with all RDF versions.</p>
@@ -664,7 +663,7 @@ <h4>Client considerations</h4>
664663
<li>Ignore the version directive.</li>
665664
<li>Raise an error and abort.</li>
666665
<li>Issue a warning and ignore the triple.</li>
667-
<li>Parse the structure, but emit triples consistent with the declared version.</li>
666+
<li>Parse the structure and only emit triples consistent with the declared version.</li>
668667
</ul>
669668
</section>
670669
</section>

0 commit comments

Comments
 (0)