Add issue noting structural refactoring.

w3c · Feb 11, 2020 · e54cf87 · e54cf87
1 parent 4745d4c
commit e54cf87
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 4 deletions.
diff --git a/index.html b/index.html
@@ -142,6 +142,14 @@
 </head>
 <body>
   <section id='abstract'>
+    <p class="issue">
+This document is undergoing a major structural refactoring and will not be easy
+to read. A <a href="https://www.w3.org/TR/2019/WD-did-core-20191209/">previously
+published version</a> that has a better topical flow may be a better read for
+people new to this work. When this document has been updated to have a
+better flow, this comment will be removed.
+    </p>
+
     <p>
 <a>Decentralized identifiers</a> (DIDs) are a new type of identifier to
 provide verifiable, decentralized digital identity. These new identifiers are
@@ -1893,8 +1901,8 @@ <h2>
       <p>
 JSON-LD is useful when extending the data model described in this specification.
 Instances of the data model are encoded in JSON-LD in the same way they are
-encoded in JSON (see Section <a href="#json"></a>), with the addition of the
-<code>@context</code> property. The
+encoded in JSON (see Section <a href="#pure-json"></a>), with the addition of
+the <code>@context</code> property. The
 <a href="https://www.w3.org/TR/json-ld/#the-context">JSON-LD Context</a>
 is described in detail in the [[!JSON-LD]] specification and its use is
 elaborated on in Section <a href="#extensibility"></a>.

diff --git a/terms.html b/terms.html
@@ -70,7 +70,7 @@
   <dt><dfn data-lt="did controllers|did controller(s)">DID controller</dfn></dt>
 
   <dd>
-The entity that has the ability to make changes to a <a>DID document</a>. 
+The entity that has the ability to make changes to a <a>DID document</a>.
 A <a>DID</a> can have more than one controller. The <a>DID controller(s)</a>
 are denoted by the `controller` property on the top level of the <a>DID
 document</a>. Note that the <a>DID controller(s)</a> might include the
@@ -193,7 +193,7 @@
   <dd>
 The specific intent for a proof, the reason why an entity created it.
 Acts as a safeguard to prevent the proof from being misused for a purpose
-other than the one it was intended for. 
+other than the one it was intended for.
   </dd>
 
   <dt><dfn>JSON Pointer</dfn></dt>