Stub introduction / abstract

ioggstream · gkellogg · commit 2a627a4e10e7 · 2022-06-29T14:01:59.000-07:00
diff --git a/spec/index.html b/spec/index.html
@@ -199,7 +199,12 @@
   <body>
     <section id='abstract'>
       <p>
-        FIXME.
+        In recent years, YAML emerged as a more concise format
+        to represent information serialized as JSON,
+        including Linked Data.
+        This document defines how to serialize linked data
+        in YAML documents.
+        Moreover, it registers the application/ld+yaml media type.
       </p>
     </section>
 
@@ -211,8 +216,20 @@
 
     <section>
       <h2>Introduction</h2>
-      <p>FIXME.</p>
-
+      <p>
+        JSON-LD is a JSON-based format to serialize Linked Data.
+        In recent years, YAML emerged as a more concise format
+        to represent information serialized as JSON,
+        including API specification, data schemas and Linked Data.
+      </p>
+      <p>
+        Since YAML is more expressive than JSON,
+        both in the available data types and in the document structure,
+        (see I-D.ietf-yaml-mediatypes)
+        this document identifies constraints on YAML documents
+        so that they can be used to represent JSON-LD documents.
+      </p>
+        
   <section id="conformance">
     <p>A <a>YAML-LD document</a> complies with this specification if ...</p>
 
