diff --git a/index.html b/index.html index 2e9d638b..32e4bfa3 100644 --- a/index.html +++ b/index.html @@ -922,11 +922,11 @@

DID Parameters

-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 @@

DID Parameters

-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.

@@ -1026,11 +1025,11 @@

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 @@

The DID URL dereferencing function dereferences a DID URL into a resource with contents depending on the DID URL's components, including the DID method, method-specific identifier, path, query, -and fragment. This process depends on DID resolution -of the DID contained in the DID URL. -The details of how this -process is accomplished are outside the scope of this specification, but all -conformant implementations MUST implement a function which has the -following abstract form: +and fragment. This process depends on DID resolution of the DID +contained in the DID URL. +The details of how this process is accomplished are outside the scope of this +specification, but all conformant implementations MUST implement a function +which has the following abstract form:

@@ -3472,18 +3470,18 @@

A conformant DID URL as a single string. This is the DID URL to -dereference. -This input is REQUIRED. +dereference. To dereference a DID fragment, the complete DID URL +including the DID fragment MUST be used. This input is REQUIRED.
did-url-dereferencing-input-metadata
A metadata structure consisting of input -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. +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.