Apply non-normative DID Resolution suggestions from @jricher.

Co-Authored-By: Justin Richer <[email protected]>

index.html

@@ -634,15 +634,14 @@ <h2>DID Resolvers</h2>
 
       <p>
 A <a>DID resolver</a> is a software and/or hardware component that takes a
-<a>DID</a> as input and produces a <a>conforming DID document</a> as output.
-This process is called <a>DID resolution</a> and often includes resolution input
-options and resolution output metadata.
+<a>DID</a> (and associated options) as input and produces a <a>conforming 
+DID document</a> (and associated metadata) as output in a process 
+called <a>DID resolution</a>.
       </p>
       <p>
-The general process of <a>DID resolution</a> is described in
-<a href="#did-resolution"></a>. The details of implementing a
-<a>DID resolver</a> are described in the DID Resolution specification
-[[?DID-RESOLUTION]].
+The inputs and outputs of the <a>DID resolution</a> process are defined in
+<a href="#did-resolution"></a>. Additional considerations for implementing a
+<a>DID resolver</a> are discussed in [[?DID-RESOLUTION]].
       </p>
     </section>
 
@@ -651,21 +650,20 @@ <h2>DID Dereferencers</h2>
 
       <p>
 A <a>DID URL dereferencer</a> is a software and/or hardware component that takes
-a <a>DID URL</a> as input and produces a resource, which might or might not be a
-<a>conforming DID Document</a> as output. This process is called <a>DID URL
-dereferencing</a> and often includes dereferencing input options and
-dereferencing output metadata. Generally, a <a>DID URL dereferencer</a> uses a
+a <a>DID URL</a> as input (and associated options) and produces a resource (and
+associated metadata) as output in a process called <a>DID URL
+dereferencing</a>. The resource produced by <a>DID URL dereferencing</a> might or might not be a
+<a>conforming DID Document</a>. Generally, a <a>DID URL dereferencer</a> uses a
 <a>DID resolver</a> to execute <a>DID resolution</a> on the <a>DID</a> portion
 of a <a>DID URL</a> to obtain a <a>DID document</a>. The <a>DID URL
 dereferencer</a> can then perform additional dereferencing on the <a>DID
-document</a> using the absolute <a>DID URL</a>.
+document</a> using the complete <a>DID URL</a>.
       </p>
 
       <p>
-The general process of <a>DID URL dereferencing</a> is described in
-<a href="#did-url-dereferencing"></a>. The details of implementing a <a>DID URL
-dereferencer</a> are described in the DID Resolution specification
-[[?DID-RESOLUTION]].
+The inputs and outputs of the <a>DID URL dereferencing</a> process are defined in
+<a href="#did-url-dereferencing"></a>. Additional considerations for implementing a 
+<a>DID URL dereferencer</a> are discussed in [[?DID-RESOLUTION]].
       </p>
     </section>
 
@@ -1114,7 +1112,7 @@ <h2>Fragment</h2>
   <a>public key description</a> or <a>service endpoint</a>). <a>DID fragment</a>
   syntax and semantics are identical to a generic URI fragment and  MUST conform
   to <a data-cite="RFC3986#section-3.5">RFC&nbsp;3986, section 3.5</a>. To dereference
-  a <a>DID fragment</a> reference, the complete <a>DID URL</a> including the
+  a <a>DID fragment</a>, the complete <a>DID URL</a> including the
   <a>DID fragment</a> MUST be used as input to the <a>DID URL dereferencing</a>
   function for the target component in the <a>DID document</a> object. For more
   information, see <a href="#did-url-dereferencing"></a>.
@@ -2585,7 +2583,7 @@ <h1>
 
     <p>
 This section defines the inputs and outputs of the
-<a>DID resolution</a> and <a>DID URL dereferencing</a> functions. The
+<a>DID resolution</a> and <a>DID URL dereferencing</a> processes. The
 exact implementation of these functions is out of scope for this specification,
 but some considerations for implementors are available in [[?DID-RESOLUTION]].
     </p>
@@ -2604,7 +2602,7 @@ <h2>
 
     <section>
         <h2>
-Resolution Metadata
+Metadata Structure
         </h2>
     </section>
 

terms.html

@@ -133,10 +133,10 @@
   <dt><dfn>DID resolution</dfn></dt>
 
   <dd>
-The function that takes as its input a <a>DID</a> and a set of resolution
-options and returns a <a>DID document</a> in a conforming representation
+The function that takes as its input a <a>DID</a> and a set of input
+metadata and returns a <a>DID document</a> in a conforming representation
 plus additional metadata. This function relies on the "Read" operation of the
-applicable <a>DID method</a>. The contract of this function is defined
+applicable <a>DID method</a>. The inputs and outputs of this function are defined
 in <a href="#did-resolution"></a>.
   </dd>
 
@@ -145,7 +145,7 @@
   <dd>
 A <a>DID resolver</a> is a software and/or hardware component that takes
 a <a>DID</a> as input and produces a <a>conforming DID document</a> as
-output.
+output by performing <a>DID resolution</a>.
   </dd>
 
   <dt><dfn data-lt="DID schemes">DID scheme</dfn></dt>
@@ -179,17 +179,16 @@
 a <a>DID document</a>, plus additional metadata. This function can use the <a>DID resolution</a>
 function to fetch a <a>DID document</a> indicated by the <a>DID</a> within the <a>DID URL</a>.
 The dereferencing function then can perform additional processing on the <a>DID document</a> to return
-the dereferenced resource indicated by the <a>DID URL</a>. The contract of this
-function is defined in <a href="#did-url-dereferencing"></a>.
+the dereferenced resource indicated by the <a>DID URL</a>. The inputs and outputs of this
+process are defined in <a href="#did-url-dereferencing"></a>.
   </dd>
 
   <dt><dfn data-lt"DID URL dereferencers">DID URL dereferencer</dfn></dt>
 
   <dd>
 A software and/or hardware system that is capable of executing the <a>DID URL dereferencing</a>
 function, retrieving some form of data, which might or might not be a <a>DID document</a>) for a given
-<a>DID URL</a>. The details of systems are specified in the DID Resolution specification
-[[?DID-RESOLUTION]].
+<a>DID URL</a> by performing <a>DID URL dereferencing</a>.
   </dd>
 
   <dt><dfn data-lt="distributed ledger technology|DLT">distributed ledger</dfn> (DLT)</dt>