Skip to content

Commit

Permalink
Fix: #156. Update media type registration information. (#157)
Browse files Browse the repository at this point in the history
* Fix: #156. Update media type registration information.
* RFC9512 is in specref. YAML 1.2.2 is not
* YAML 1.2.2 is in specref too ;)
* Change contact information to WG..

---------

Co-authored-by: Gregg Kellogg <[email protected]>
  • Loading branch information
ioggstream and gkellogg authored Nov 14, 2024
1 parent 04674fe commit d11f6e5
Showing 1 changed file with 14 additions and 34 deletions.
48 changes: 14 additions & 34 deletions spec/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -32,19 +32,6 @@
}],

localBiblio: {
"I-D.ietf-httpapi-yaml-mediatypes": {
title: "YAML Media Type",
href: "https://www.ietf.org/archive/id/draft-ietf-httpapi-yaml-mediatypes-03.html",
publisher: "IETF",
date: "2022-08-05",
status: "WG Document",
authors: [
"Roberto Polli",
"Erik Wilde",
"Eemeli Aro"
]
},

"json-ld-bp": {
title: "JSON-LD Best Practices",
href: "https://w3c.github.io/json-ld-bp/",
Expand All @@ -61,17 +48,6 @@
"Philippe Le Hegaret",
],
},

"YAML": {
title: "YAML Ain’t Markup Language (YAML™) version 1.2.2",
href: "https://yaml.org/spec/1.2.2/",
date: "2021-10-01",
authors: [
"Oren Ben-Kiki",
"Clark Evans",
"Ingy döt Net"
]
}
},

// Cross-reference definitions
Expand Down Expand Up @@ -355,7 +331,7 @@ <h2>Introduction</h2>
<p>
Since YAML is more expressive than JSON,
both in the available data types and in the document structure
(see [[I-D.ietf-httpapi-yaml-mediatypes]]),
(see [[RFC9512]]),
this document identifies constraints on YAML
such that any <a>YAML-LD document</a> can be represented in JSON-LD.
</p>
Expand Down Expand Up @@ -902,7 +878,7 @@ <h2>Comments</h2>
</p>

<p>
See Interoperability considerations of [[I-D.ietf-httpapi-yaml-mediatypes]]
See Interoperability considerations of "+yaml" structured syntax suffix
for more details.
</p>
</section>
Expand Down Expand Up @@ -1036,8 +1012,8 @@ <h2>Mapping Key Types</h2>
<section id="sec" class="informative">
<h2>Security Considerations</h2>

<p>See <a data-cite="JSON-LD11#iana-security">Security considerations in JSON-LD 1.1</a>.
Also, see the YAML media type registration.</p>
<p>See <a data-cite="JSON-LD11#iana-security">Security considerations in JSON-LD 1.1</a>
and <code>+yaml</code> structured syntax suffix.</p>
</section>

<section id="int" class="informative">
Expand All @@ -1046,7 +1022,7 @@ <h2>Interoperability Considerations</h2>
<p>
For general interoperability considerations on the serialization of
<a>JSON documents</a> in [[YAML]], see YAML
and the Interoperability consideration of <code>application/yaml</code> [[I-D.ietf-httpapi-yaml-mediatypes]].
and the Interoperability considerations of the <code>+yaml</code> structured syntax suffix.
</p>
<p>
The YAML-LD format and the media type registration are not restricted to a specific
Expand Down Expand Up @@ -1146,7 +1122,7 @@ <h2>Streams</h2>

<p class="note" title="Interoperability considerations on YAML streams">
For interoperability considerations on YAML streams,
see <a data-cite="I-D.ietf-httpapi-yaml-mediatypes#section-3.2">the relevant section in YAML Media Type</a>.
see <a data-cite="RFC9512#section-3.2">the relevant section in YAML Media Type</a>.
</p>
</section>

Expand Down Expand Up @@ -1212,7 +1188,7 @@ <h3>application/ld+yaml</h3>
</dl>
</dd>
<dt>Encoding considerations:</dt>
<dd>See <a data-cite="I-D.ietf-httpapi-yaml-mediatypes#">YAML media type</a>.</dd>
<dd>Same as <code>+yaml</code>.</dd>
<dt id="iana-security">Security considerations:</dt>
<dd>See <a href="#sec" class="sectionRef"></a>.</dd>
<dt>Interoperability considerations:</dt>
Expand All @@ -1226,8 +1202,10 @@ <h3>application/ld+yaml</h3>
<dt>Additional information:</dt>
<dd>
<dl>
<dt>Deprecated alias names for this type:</dt>
<dd>N/A</code></dd>
<dt>Magic number(s):</dt>
<dd>See <code>application/yaml</code></dd>
<dd>Same as <code>application/yaml</code></dd>
<dt>File extension(s):</dt>
<dd>
<ul>
Expand All @@ -1236,11 +1214,13 @@ <h3>application/ld+yaml</h3>
</ul>
</dd>
<dt>Macintosh file type code(s):</dt>
<dd>TEXT</dd>
<dd>Same as <code>application/yaml</code></dd>
<dt>Windows Clipboard Name:</dt>
<dd>Same as <code>application/yaml</code></dd>
</dl>
</dd>
<dt>Person &amp; email address to contact for further information:</dt>
<dd>Philippe Le Hégaret &lt;plh@w3.org&gt;</dd>
<dd>W3C JSON-LD Working Group &lt;public-json-ld-wg@w3.org&gt;</dd>
<dt>Intended usage:</dt>
<dd>Common</dd>
<dt>Restrictions on usage:</dt>
Expand Down

0 comments on commit d11f6e5

Please sign in to comment.