diff --git a/common.js b/common.js index e533f10be..3e86e9b0c 100644 --- a/common.js +++ b/common.js @@ -138,6 +138,13 @@ var vcwg = { authors: ['Orie Steele', 'Michael Jones'], status: 'ED', publisher: 'W3C Verifiable Credentials Working Group' + }, + 'VC-SPECS': { + title: 'Verifiable Credentials Specifications Directory', + href: 'https://w3c.github.io/vc-specs-dir/', + authors: ['Manu Sporny'], + status: 'ED', + publisher: 'W3C Verifiable Credentials Working Group' } } }; diff --git a/index.html b/index.html index f0207d43a..fd050e171 100644 --- a/index.html +++ b/index.html @@ -3250,6 +3250,70 @@

Authorization

on top of this specification.

+ +
+

Reserved Extension Points

+ +

+This specification reserves a number of properties to serve as possible +extension points. While some implementers signaled interest in these properties, +their inclusion in this specification was considered to be premature; these +extension points might be more formally defined in future versions of this +specification. It is important to note that these properties are not defined by +this specification and implementers are cautioned that usage of these properties +is considered experimental. +

+

+Implementers MAY use these properties, but SHOULD expect them and/or +their meanings to change during the process to normatively specify them. +Implementers SHOULD NOT use these properties without a publicly disclosed +specification describing their implementation. +

+ +

+In order to avoid collisions regarding how the following properties are used, +implementations MUST specify a `type` property in the value associated with the +reserved property. For more information related to adding `type` information, +see Section . +

+ +

+The following extension point properties are under consideration for being +marked as reserved: `presentationSchema`, `credentialRefresh`, `termsOfUse`, +`evidence`, `renderMethod`, `refreshService`, and +`confirmationMethod/confidenceMethod`. +

+ + + + + + + + + + + + + + + + +
Reserved PropertyDescription
+`example` + +An example entry for a reserved property. +
+ +

+An unofficial list of specifications that are associated with the extension +points defined in this specification, as well as the reserved extension points +defined in this section, can be found in the Verifiable Credentials +Specifications Directory [[?VC-SPECS]]. Items in the directory that refer to +reserved extension points SHOULD be treated as experimental. +

+ +