From c2466a24df0cfb2abc517ad5fa978d65a038e980 Mon Sep 17 00:00:00 2001
From: Manu Sporny <msporny@digitalbazaar.com>
Date: Sat, 6 Jan 2024 11:35:59 -0500
Subject: [PATCH] Update references to controller documents, add at risk
 marker.

---
 index.html | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/index.html b/index.html
index 9e56a2aa8..87c3f941e 100644
--- a/index.html
+++ b/index.html
@@ -1746,9 +1746,9 @@ <h3>Issuer</h3>
 whose value is a [=URL=]; in either case, the issuer selects this
 [=URL=] to identify itself in a globally unambiguous
 way. It is RECOMMENDED that the [=URL=] be one which, if dereferenced,
-results in a controller document [[?VC-CONTROLLER-DOCUMENT]] about the
-[=issuer=] that can be used to [=verify=] the information expressed in
-the [=credential=].
+results in a controller document, as defined in [[VC-DATA-INTEGRITY]] or
+[[VC-JOSE-COSE]], about the [=issuer=] that can be used to [=verify=] the
+information expressed in the [=credential=].
           </dd>
         </dl>
 
@@ -4000,11 +4000,13 @@ <h3>Securing Mechanism Specifications</h3>
           </dd>
           <dt>[=string=] |controller|</dt>
           <dd>
-A verification method controller as defined in [[VC-CONTROLLER-DOCUMENT]].
+A verification method controller as defined in [[VC-DATA-INTEGRITY]] or
+[[VC-JOSE-COSE]].
           </dd>
           <dt>[=map=] |controllerDocument|</dt>
           <dd>
-A controller document as defined in [[VC-CONTROLLER-DOCUMENT]].
+A controller document as defined in [[VC-DATA-INTEGRITY]] or
+[[VC-JOSE-COSE]].
           </dd>
         </dl>
 
@@ -4023,7 +4025,7 @@ <h3>Securing Mechanism Specifications</h3>
         </p>
 
         <p class="note"
-            title="Choice of securing mechanism is use-case dependent">
+           title="Choice of securing mechanism is use-case dependent">
 There are multiple acceptable securing mechanisms, and this specification does
 not mandate any particular securing mechanism for use with
 [=verifiable credentials=] or [=verifiable presentations=].
@@ -4036,6 +4038,17 @@ <h3>Securing Mechanism Specifications</h3>
 of the [[[?VC-SPECS]]] [[?VC-SPECS]].
         </p>
 
+        <p class="issue atrisk"
+           title="Controller document reference might change">
+The Working Group is currently attempting to align the definitions of a
+controller document between [[[?DID-CORE]]], [[[VC-DATA-INTEGRITY]]], and
+[[[VC-JOSE-COSE]]]. The goal is to have one specification that each of the
+previously stated specifications, and this specification, can reference for
+the normative statements related to controller documents. The normative
+references to controller documents are expected to change during the
+Candidate Recommendation phase.
+        </p>
+
       </section>
 
     </section>