Skip to content

Commit

Permalink
Update wording about controller property to suggestion by @brentzundel
Browse files Browse the repository at this point in the history
  • Loading branch information
rhiaro authored and msporny committed Sep 7, 2020
1 parent 04fcfb9 commit 001abab
Showing 1 changed file with 9 additions and 14 deletions.
23 changes: 9 additions & 14 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1371,6 +1371,15 @@ <h2>
</dd>
</dl>

<p>
When a <code><a>controller</a></code> property is present in a
<a>DID Document</a>, its value expresses one or more <a>DIDs</a>. Any
<a>verification methods</a> contained in the <a>DID Documents</a> for those
<a>DIDs</a> SHOULD be accepted as authoritative, such that proofs that satisfy
those verification methods are to be considered equivalent to proofs provided
by the <a>DID Subject</a>.
</p>

<p class="note" title="Authorization vs authentication">
Note that Authorization is separate from <a href="#authentication"></a>.
This is particularly important for key recovery in the case of key loss,
Expand All @@ -1394,20 +1403,6 @@ <h2>
}]
}
</pre>

<p class="note" title="Determining the DID controller">
If the <code><a>controller</a></code> property is present, its value expresses
the root of authority for information expressed in the <a>DID Document.</a> If
the <code><a>controller</a></code> property is not present, the value can be
inferred to be the same as that of the <code><a>id</a></code> property of the
<a>DID document</a>. The way to determine how the <a>DID Document</a> can be
changed is by consulting the relevant <a>DID method</a>. If no <a>verification
methods</a> are present in the <a>DID Document</a>, then a
<code><a>controller</a></code> property MUST be present, otherwise the
the <a>DID document</a> can no longer be changed beyond whatever its present
value is.
```suggestion
</p>
</section>

<section>
Expand Down

0 comments on commit 001abab

Please sign in to comment.