diff --git a/index.html b/index.html index e20855c9..e6120615 100644 --- a/index.html +++ b/index.html @@ -142,6 +142,14 @@
+

+This document is undergoing a major structural refactoring and will not be easy +to read. A previously +published version 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. +

+

Decentralized identifiers (DIDs) are a new type of identifier to provide verifiable, decentralized digital identity. These new identifiers are @@ -1893,8 +1901,8 @@

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 ), with the addition of the -@context property. The +encoded in JSON (see Section ), with the addition of +the @context property. The JSON-LD Context is described in detail in the [[!JSON-LD]] specification and its use is elaborated on in Section . diff --git a/terms.html b/terms.html index e4da3c61..7aa52cd6 100644 --- a/terms.html +++ b/terms.html @@ -70,7 +70,7 @@

DID controller
-The entity that has the ability to make changes to a DID document. +The entity that has the ability to make changes to a DID document. A DID can have more than one controller. The DID controller(s) are denoted by the `controller` property on the top level of the DID document. Note that the DID controller(s) might include the @@ -193,7 +193,7 @@
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.
JSON Pointer