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

Implement a Structured Abstract (PR #4 for issue #94) #109

Merged
merged 8 commits into from
Jul 22, 2023
Merged
45 changes: 39 additions & 6 deletions spec/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -270,12 +270,45 @@
<body>
<section id='abstract'>
<p>
In recent years, [[YAML]] has emerged as a more concise format
to represent information that had previously been serialized as JSON,
including Linked Data.
This document defines how to serialize linked data
in YAML.
Moreover, it registers the `application/ld+yaml` media type.
<strong>Objective</strong><br>
This document defines YAML-LD, a set of conventions built on top
of YAML, which outlines how to serialize Linked Data as YAML
based on JSON-LD syntax, semantics, and APIs. The emergence of
YAML as a more concise format for representing information
previously serialized as JSON, including Linked Data, has led to
the development of YAML-LD.
</p>

<p>
<strong>Methods</strong><br>
This document defines constraints on YAML so that any YAML-LD
document can be represented in JSON-LD. This is necessary
because YAML is more expressive than JSON, in terms of both
available data types and document structure. This document
also registers the <code>application/ld+yaml</code> media type.
</p>

<p>
<strong>Results</strong><br>
This document provides a clear description of how to serialize
linked data in YAML. It also describes the basic concepts and
core requirements for implementing YAML-LD, including a
comparison of JSON versus YAML, the supported YAML features,
and encoding considerations.
</p>

<p>
<strong>Limitations</strong><br>
The YAML feature set is richer than that of JSON, and a number of
YAML features are not supported in this specification. However,
ground is laid for future development of a version of YAML-LD
which will support those features — via the Extended YAML-LD
Profile.
</p>
<p>
<strong>Conclusions</strong><br>
YAML-LD offers an efficient way to encode Linked Data in a
variety of programming languages which can use YAML.
</p>
</section>

Expand Down