From 2327b382a334a25cbc5cd9c0c911acd686867708 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Thu, 23 Apr 2020 09:12:34 -0400 Subject: [PATCH] Apply non-normative DID Resolution suggestions from @jricher. Co-Authored-By: Justin Richer --- index.html | 36 +++++++++++++++++------------------- terms.html | 15 +++++++-------- 2 files changed, 24 insertions(+), 27 deletions(-) diff --git a/index.html b/index.html index c275cf58..54201090 100644 --- a/index.html +++ b/index.html @@ -634,15 +634,14 @@

DID Resolvers

A DID resolver is a software and/or hardware component that takes a -DID as input and produces a conforming DID document as output. -This process is called DID resolution and often includes resolution input -options and resolution output metadata. +DID (and associated options) as input and produces a conforming +DID document (and associated metadata) as output in a process +called DID resolution.

-The general process of DID resolution is described in -. The details of implementing a -DID resolver are described in the DID Resolution specification -[[?DID-RESOLUTION]]. +The inputs and outputs of the DID resolution process are defined in +. Additional considerations for implementing a +DID resolver are discussed in [[?DID-RESOLUTION]].

@@ -651,21 +650,20 @@

DID Dereferencers

A DID URL dereferencer is a software and/or hardware component that takes -a DID URL as input and produces a resource, which might or might not be a -conforming DID Document as output. This process is called DID URL -dereferencing and often includes dereferencing input options and -dereferencing output metadata. Generally, a DID URL dereferencer uses a +a DID URL as input (and associated options) and produces a resource (and +associated metadata) as output in a process called DID URL +dereferencing. The resource produced by DID URL dereferencing might or might not be a +conforming DID Document. Generally, a DID URL dereferencer uses a DID resolver to execute DID resolution on the DID portion of a DID URL to obtain a DID document. The DID URL dereferencer can then perform additional dereferencing on the DID -document using the absolute DID URL. +document using the complete DID URL.

-The general process of DID URL dereferencing is described in -. The details of implementing a DID URL -dereferencer are described in the DID Resolution specification -[[?DID-RESOLUTION]]. +The inputs and outputs of the DID URL dereferencing process are defined in +. Additional considerations for implementing a +DID URL dereferencer are discussed in [[?DID-RESOLUTION]].

@@ -1114,7 +1112,7 @@

Fragment

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 reference, the complete DID URL including the + 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 . @@ -2585,7 +2583,7 @@

This section defines the inputs and outputs of the -DID resolution and DID URL dereferencing functions. The +DID resolution and DID URL dereferencing processes. The exact implementation of these functions is out of scope for this specification, but some considerations for implementors are available in [[?DID-RESOLUTION]].

@@ -2604,7 +2602,7 @@

-Resolution Metadata +Metadata Structure

diff --git a/terms.html b/terms.html index f0ab1728..5a3a0e3f 100644 --- a/terms.html +++ b/terms.html @@ -133,10 +133,10 @@
DID resolution
-The function that takes as its input a DID and a set of resolution -options and returns a DID document in a conforming representation +The function that takes as its input a DID and a set of input +metadata and returns a DID document in a conforming representation plus additional metadata. This function relies on the "Read" operation of the -applicable DID method. The contract of this function is defined +applicable DID method. The inputs and outputs of this function are defined in .
@@ -145,7 +145,7 @@
A DID resolver is a software and/or hardware component that takes a DID as input and produces a conforming DID document as -output. +output by performing DID resolution.
DID scheme
@@ -179,8 +179,8 @@ a DID document, plus additional metadata. This function can use the DID resolution function to fetch a DID document indicated by the DID within the DID URL. The dereferencing function then can perform additional processing on the DID document to return -the dereferenced resource indicated by the DID URL. The contract of this -function is defined in . +the dereferenced resource indicated by the DID URL. The inputs and outputs of this +process are defined in .
DID URL dereferencer
@@ -188,8 +188,7 @@
A software and/or hardware system that is capable of executing the DID URL dereferencing function, retrieving some form of data, which might or might not be a DID document) for a given -DID URL. The details of systems are specified in the DID Resolution specification -[[?DID-RESOLUTION]]. +DID URL by performing DID URL dereferencing.
distributed ledger (DLT)