From 7043ae03246836568d74f33720bdebf75843513c Mon Sep 17 00:00:00 2001
From: Anatoly Scherbakov <altaisoft@gmail.com>
Date: Sat, 13 May 2023 23:24:52 +0400
Subject: [PATCH] =?UTF-8?q?#97=20Basic=20=E2=86=92=20Extended=20conversion?=
 =?UTF-8?q?=20requires=20JSON-LD=20intermediate=20form?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 spec/index.html | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/spec/index.html b/spec/index.html
index 86a8b7c..9bd679f 100644
--- a/spec/index.html
+++ b/spec/index.html
@@ -2416,7 +2416,9 @@ <h2>Convert Extended YAML-LD to Basic YAML-LD and back</h2>
           <dt><code>basic_to_extended(basic_document: YAML-LD) → YAML-LD</code></dt>
           <dd>
             <ul>
-              <li>Performs JSON-LD expansion to the given Basic YAML-LD document</li>
+              <li>Converts YAML-LD → JSON</li>
+              <li>Performs JSON-LD expansion → the resulting JSON-LD document</li>
+              <li>Converts Expanded JSON-LD document back to YAML-LD</li>
               <li>
                 Converts it to the Extended form, making
                 use of YAML-LD features to express the document more concisely.
@@ -2425,6 +2427,19 @@ <h2>Convert Extended YAML-LD to Basic YAML-LD and back</h2>
           </dd>
         </dl>
 
+        <div class="note">
+          ou won't typically need to perform these steps manually
+          because libraries such as <code>rdflib</code> will take care of them
+          under the covers, but it can help with troubleshooting and
+          optimization to know what's going on. So, you start with YAML,
+          convert it to JSON, perform JSON-LD Expansion, convert that to
+          YAML-LD, and do any necessary basic → extended or extended → basic
+          conversion on the YAML-LD. Alternatively, your library might do
+          YAML-LD expansion directly on the initial YAML document, and then
+          do any necessary basic → extended or extended → basic conversion on
+          the YAML-LD.
+        </div>
+
         <p>
           Both of these functions recursively process the source document.
           Every branch and leaf are copied as is, unless they match one of the following