diff --git a/index.html b/index.html index 2e9d638b..32e4bfa3 100644 --- a/index.html +++ b/index.html @@ -922,11 +922,11 @@
-Implementers as well as DID method specification authors MAY use additional -DID parameters that are not listed here. -For maximum interoperability, it is RECOMMENDED that DID parameters use the official -W3C DID Specification Registries mechanism [[DID-SPEC-REGISTRIES]], to avoid collision -with other uses of the same DID parameter with different semantics. +Implementers as well as DID method specification authors MAY use +additional DID parameters that are not listed here. For maximum +interoperability, it is RECOMMENDED that DID parameters use the official W3C +DID Specification Registries mechanism [[DID-SPEC-REGISTRIES]], to avoid +collision with other uses of the same DID parameter with different semantics.
@@ -948,8 +948,8 @@
-Adding a DID parameter to a DID URL means that the parameter becomes part
-of an identifier for a resource (the DID document or other).
+Adding a DID parameter to a DID URL means that the parameter becomes
+part of an identifier for a resource (the DID document or other).
Alternatively, the DID resolution and the DID URL dereferencing
functions can also be influenced by passing input metadata to a DID
resolver that are not part of the DID URL. (See DID Parameters
DID parameters MAY be used if there is a clear use case where the parameter
-needs to be part of a URI that can be used as a link, or as a resource in
-RDF / JSON-LD documents.
+needs to be part of a URI that can be used as a link, or as a resource
+in RDF / JSON-LD documents.
-DID parameters SHOULD NOT be used if the same functionality can be expressed by
-passing input metadata to a DID resolver, and if there is no need to construct a
-URI for use as a link, or as a resource in RDF / JSON-LD documents.
+It is expected that DID parameters will not be used if the same
+functionality can be expressed by passing input metadata to a DID resolver.
Fragment
document to identify a component of the document (for example, a unique
public key description or service endpoint). DID fragment
syntax and semantics are identical to a generic URI fragment and MUST conform
-to RFC 3986, section 3.5. To
-dereference a DID fragment, the complete DID URL including the
-DID fragment MUST be used as input to the DID URL dereferencing
-function for the target component in the DID document object. For more
-information, see .
+to RFC 3986, section 3.5.
+
+For information about how to dereference a DID fragment, see +.
@@ -3449,12 +3448,11 @@
@@ -3472,18 +3470,18 @@
dereference
function in addition to the did-url
-itself.
-Properties defined by this specification are in .
-This input is REQUIRED, but the structure MAY be empty.
+options to the dereference
function in addition to the
+did-url
itself. Properties defined by this specification are in
+. This input is
+REQUIRED, but the structure MAY be empty.