Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Consolodate duplicate How to read this document sections. #93

Merged
merged 1 commit into from Jan 8, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
47 changes: 16 additions & 31 deletions index.html
Expand Up @@ -368,53 +368,36 @@ <h1>Introduction</h1>
they relate to "nest" into a particular tree structure that matches what
their application expects.</p>

<section class="informative">
<h2>How to Read this Document</h2>

<p>
This document is a detailed specification for a serialization of Linked
Data in JSON. The document is primarily intended for the following audiences:
</p>

<ul>
<li>Authors who want to query JSON-LD documents to create representations
more appropriate for a given use case.</li>
<li>Software developers that want to implement <a>processors</a> and APIs for
JSON-LD.</li>
</ul>

<p>
To understand the basics in this specification you must first be familiar with
<a data-cite="RFC8259" data-no-xref="">JSON</a>, which is detailed in [[RFC8259]]. You must also understand the
JSON-LD 1.1 Syntax specification [[JSON-LD11]], which is the base syntax used by all of the
algorithms in this document,
and the JSON-LD 1.1 API [[JSON-LD11-API]]. To understand the API and how it is
intended to operate in a programming environment, it is useful to have working
knowledge of the JavaScript programming language [[ECMASCRIPT]] and
WebIDL [[WEBIDL]]. To understand how JSON-LD maps to RDF, it is helpful to be
familiar with the basic RDF concepts [[RDF11-CONCEPTS]].</p>

</section>

<section class="informative">
<h2>How to Read this Document</h2>

<p>This document is a detailed specification for a serialization of Linked
Data in JSON. The document is primarily intended for the following audiences:</p>

<ul>
<li>Software developers who want to implement processors and APIs for
JSON-LD</li>
<li>Authors who want to query JSON-LD documents to create representations
more appropriate for a given use case.</li>
<li>Software developers that want to implement <a>processors</a> and APIs for JSON-LD.</li>
</ul>

<p>A companion document, the JSON-LD 1.1 specification
[[JSON-LD11]], specifies the grammar of JSON-LD documents.</p>

<p>To understand the basics in this specification you must first be familiar with
<a data-cite="RFC8259" data-no-xref="">JSON</a>, which is detailed in [[RFC8259]].</p>
<a data-cite="RFC8259" data-no-xref="">JSON</a>, which is detailed in [[RFC8259]].
You must also understand the JSON-LD 1.1 Syntax specification [[JSON-LD11]],
which is the base syntax used by all of the algorithms in this document,
and the JSON-LD 1.1 API [[JSON-LD11-API]].
To understand the API and how it is intended to operate in a programming environment,
it is useful to have working knowledge of
the JavaScript programming language [[ECMASCRIPT]]
and WebIDL [[WEBIDL]].
To understand how JSON-LD maps to RDF, it is helpful to be
familiar with the basic RDF concepts [[RDF11-CONCEPTS]].</p>

<p>This document can highlight changes since the [[[JSON-LD10]]] version.
Select to <button class="show-changes"></button> changes.</p>

</section>

<section class="informative">
Expand Down Expand Up @@ -3062,6 +3045,8 @@ <h2>Changes since JSON-LD Community Group Final Report</h2>
<section class="appendix informative" id="changes-from-cr">
<h2>Changes since Candidate Release of 12 December 2019</h2>
<ul>
<li>Removed duplicate <a href="#how-to-read-this-document" class="sectionRef"></a>.
This is in response to <a href="https://github.com/w3c/json-ld-framing/issues/92">Issue 92</a>.</li>
</ul>
</section>

Expand Down