diff --git a/index.html b/index.html index f6e4972f..9b65ba3f 100644 --- a/index.html +++ b/index.html @@ -421,34 +421,22 @@

DID Parameters

- Implementers as well as DID method specification authors might use + [=DID URL authors=] might use additional DID parameters that are not listed here. For maximum interoperability, it is RECOMMENDED that DID parameters use the DID Document Properties Extensions mechanism [[?DID-EXTENSIONS-PROPERTIES]], to avoid collision with other uses of the same DID parameter with different semantics.

-

- DID parameters might be used if there is a clear use case where the parameter - needs to be part of a URL that references a resource with more - precision than using the DID alone. It is expected that DID parameters - are not used if the same functionality can be expressed by passing - input metadata to a DID resolver. -

-

The DID resolution and the DID URL dereferencing functions can be influenced by passing or - to a DID resolver that are + to a DID resolver, or a DID URL dereferencer that are not part of the DID URL. This is comparable to HTTP, where certain parameters could either be included in an HTTP URL, or - alternatively passed as HTTP headers during the dereferencing process. The - important distinction is that DID parameters that are part of the DID - URL should be used to specify what resource is being - identified, whereas input metadata that is not part of the DID URL - should be used to control how that resource is resolved or - dereferenced. + alternatively passed as HTTP headers during the dereferencing process.

+

If [=Resolve=] or [=Dereference=] is called with a resolution option of the same name as a DID parameter in the input DID URL, the resolution option MUST override the DID parameters, when interpreted by the Resolver or Dereferencer, respectively.

Datetime

diff --git a/terms.html b/terms.html index 15710ef6..a7385c99 100644 --- a/terms.html +++ b/terms.html @@ -11,6 +11,10 @@
client
Software and/or hardware that invokes a DID resolver in order to execute the DID resolution and/or DID URL dereferencing algorithms. This invocation is done via a binding. The term client does not imply any specific network topology.
+
DID URL Author
+
The creator of a DID URL. Like any URL, DID URLs are strings, typically produced in one context and often consumed in another (although constructing a DID URL for a particular use case might immediately use that DID URL in the context it was created). DID URL authors are responsible for properly constructing the DID URL and using any path, query, and fragment parts correctly such that is complies with the DID URL Syntax defined in [[DID-CORE]].
+ +
DID resolution result
A data structure that represents the result of the DID resolution algorithm. May contain a DID document. See Section .