diff --git a/index.html b/index.html index cf8ac74..d68eab9 100644 --- a/index.html +++ b/index.html @@ -669,6 +669,35 @@
+This section outlines the core data model concepts. These are elaborated +in . +
+ +A DID MUST be persistent and immutable, i.e., bound to an entity once -and never changed (forever). +and never changed (forever).
@@ -822,7 +851,7 @@
+DID Documents are the serialization of the . If a DID is the index key in a key-value pair, then the DID Document is the value to which the index key points. The combination of a DID and its associated DID Document forms the root record for a decentralized @@ -860,63 +890,10 @@
-A DID Document MUST be a single JSON object conforming to [[RFC7159]]. -For purposes of this version of the DID specification, the format of -this JSON object is specified in JSON-LD, a format for mapping JSON data into -the RDF semantic graph model as defined by [[JSON-LD]]. Future versions -of this specification MAY specify other semantic graph formats for a -DID Document such as JXD (JSON XDI Data), a serialization format for -the -XDI graph model. -
- --The following sections define the properties of this JSON object, +The following sections define the properties of the DID Document, including whether these properties are required or optional.
--JSON objects in JSON-LD format must include a JSON-LD context -statement. The rules for this statement are: -
- -@context
.
- https://w3id.org/did/v1
.
- -Example (using an example URL): -
- --{ - "@context": "https://w3id.org/did/v1" -} --
-DID method specifications MAY define their own JSON-LD contexts. -However it is NOT RECOMMENDED to define a new context unless -necessary to properly implement the method. Method-specific contexts -MUST NOT override the terms defined in the generic DID context. -
-+A DID Document MUST be a single JSON object conforming to [[RFC7159]]. +Many of the concepts in this document were introduced by example using the +JSON-LD syntax, a format for mapping JSON data into the RDF semantic graph model as defined by +[[!JSON-LD]]. This section formalizes how the data model (described in Sections + and ) is realized in JSON-LD. +
++Although syntactic mappings are provided for JSON-LD only, applications and +services can use any other data representation syntax, such as JXD (JSON XDI Data, a serialization format for +the +XDI graph model), XML, YAML, or CBOR, that is capable of expressing the data model. +
+ ++JSON objects in JSON-LD format must include a JSON-LD context +statement. The +JSON-LD Context +is described in detail in the [[!JSON-LD]] specification. The rules for this +statement are: +
+ +@context
.
+ https://w3id.org/did/v1
.
+ +Example (using an example URL): +
+ ++{ + "@context": "https://w3id.org/did/v1" +} ++
+DID method specifications MAY define their own JSON-LD contexts. +However it is NOT RECOMMENDED to define a new context unless +necessary to properly implement the method. Method-specific contexts +MUST NOT override the terms defined in the generic DID context. +
+