Skip to content

Commit d68c608

Browse files
committed
Use case for issue #6.
1 parent 9e4a544 commit d68c608

File tree

1 file changed

+35
-16
lines changed

1 file changed

+35
-16
lines changed

UCR/index.html

+35-16
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!DOCTYPE html>
2-
<html>
2+
<html lang="en">
33
<head>
44
<meta charset='utf-8'>
55
<title>YAML-LD Use Cases and Requirements</title>
@@ -47,20 +47,20 @@ <h2>Introduction</h2>
4747
and <a href="https://github.com/json-ld/yaml-ld/issues?q=is%3Aissue+is%3Aopen+label%3Aucr">issues</a>
4848
of the community's GitHub repository.
4949

50-
<section>
51-
<h2>Contributing Use Cases and Requirements</h2>
52-
<p>
53-
<a href="https://github.com/json-ld/yaml-ld/issues/new?template=use-case.md">Create a GitHub issue following the dedicated template</a>. The suggested form is:
54-
</p>
55-
<pre>
56-
WHO: As an &lt;actor&gt;
57-
WHAT: I want a &lt;feature&gt;
58-
WHY: So that &lt;benefit&gt;
59-
</pre>
60-
<p>
61-
This is not mandatory.
62-
</p>
63-
</section>
50+
<section>
51+
<h2>Contributing Use Cases and Requirements</h2>
52+
<p>
53+
<a href="https://github.com/json-ld/yaml-ld/issues/new?template=use-case.md">Create a GitHub issue following the dedicated template</a>. The suggested form is:
54+
</p>
55+
<pre>
56+
WHO: As an &lt;actor&gt;
57+
WHAT: I want a &lt;feature&gt;
58+
WHY: So that &lt;benefit&gt;
59+
</pre>
60+
<p>
61+
This is not mandatory.
62+
</p>
63+
</section>
6464
</section>
6565

6666
<section>
@@ -70,12 +70,31 @@ <h2>Submitted Use Cases</h2>
7070
<h4>Compatibility with existing libraries</h4>
7171
<p><a href="https://github.com/json-ld/yaml-ld/issues/5">Submitted Use Case</a></p>
7272
<p>
73-
As a developer of YAML-LD processors. I want to be able to use off-the-shelf libraries for converting between JSON-LD and YAML-LD serialization formats. So that data produced in JSON-LD can be easily represented in YAML-LD and visa-versa.
73+
As a developer of YAML-LD processors, I want to be able to use off-the-shelf libraries for converting between JSON-LD and YAML-LD serialization formats. So that data produced in JSON-LD can be easily represented in YAML-LD and visa-versa.
7474
</p>
7575
<p class="note">
7676
There seems to be general compatibility between YAML libraries that produce equivalent results when serializing data originally parsed from JSON. This should be verified, but indicates an easy way of providing a YAML-LD serialization fully round-trippable with JSON-LD.
7777
</p>
7878
</section>
79+
80+
<section>
81+
<h4>Distinguish "plain" YAML-LD from "ideomatic" YAML-LD</h4>
82+
<p><a href="https://github.com/json-ld/yaml-ld/issues/6">Submitted Use Case</a></p>
83+
<p>As a processor. I want to easily distinguish between "plain" YAML-LD and "ideomatic" YAML-LD based on the use of local tags (or similar) which may require post-parsing processing to be interpreted using the JSON-LD processig algorithms. So that more complicated processing steps can be avoided.</p>
84+
<pre class="example">
85+
!yaml-ld
86+
$context: http://schema.org/
87+
$type: Person
88+
name: Pierre-Antoine Champin
89+
</pre>
90+
<div class="note">
91+
<p>The previous example uses two such mechanisms:</p>
92+
<ul>
93+
<li>The use of `$` instead of `@` to denote JSON-LD keywords. (Note, other than for `@context`, this could be done using a standardized context defining appropriate keyword aliases).</li>
94+
<li>The hypothetical `!yaml-ld` processing instruction</li>
95+
</ul>
96+
</div>
97+
</section>
7998
</section>
8099
</body>
81100
</html>

0 commit comments

Comments
 (0)