From c8d2946f5199941e9b2f841d6c9657b3c5375ebf Mon Sep 17 00:00:00 2001
From: Manu Sporny <msporny@digitalbazaar.com>
Date: Thu, 20 Apr 2023 12:46:19 -0400
Subject: [PATCH] Apply fixes from @brentzundel and @TallTed in table of
 reserved properties.

Co-authored-by: Brent Zundel <brent.zundel@gmail.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
---
 index.html | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/index.html b/index.html
index d707ee9e0..2558dddaa 100644
--- a/index.html
+++ b/index.html
@@ -3251,19 +3251,21 @@ <h3>Authorization</h3>
         </p>
       </section>
 
-      <section class="informative">
+      <section class="normative">
         <h3>Reserved Extension Points</h3>
 
         <p>
 This specification reserves a number of <a>properties</a> serving as possible extension points. While
 some implementers signaled interest in these, their inclusion in this specification
 was considered to be premature; these extension points might be more
-formally defined in future versions of this specification. While these extension
-points are reserved in the base context, their usage is undefined by this
+formally defined in future versions of this specification. It is important to note that they are not defined by this
 specification and implementers are cautioned that usage of these properties is
 considered experimental.
         </p>
-
+Implementers MAY use these properties, but SHOULD expect these terms and/or
+their meanings to change during the process to normatively specify them.
+Implementers SHOULD NOT use these terms without a publicly disclosed
+specification describing their implementation.
         <p class="issue" title="Reserved properties under debate">
 The following extension point properties are under consideration for being
 marked as reserved: `presentationSchema`, `credentialRefresh`, `termsOfUse`,
@@ -3292,10 +3294,11 @@ <h3>Reserved Extension Points</h3>
         </table>
 
         <p>
-A list of specifications that utilize the extension points defined in this
-specification, as well as the reserved extension points listed above, can
-be found in the Verifiable Credentials Specifications Directory
-[[VC-SPECS-DIR]].
+A non-normative list of specifications that stem from the extension points defined
+in this specification, as well as the reserved extension points, can be found in
+the Verifiable Credentials Specifications Directory [[VC-SPECS-DIR]]. Items in
+the directory that refer to reserved extension points SHOULD be treated as
+experimental.
         </p>
 
       </section>