Skip to content

Commit

Permalink
Make version history and open issues into appendices
Browse files Browse the repository at this point in the history
  • Loading branch information
scouten-adobe committed Feb 4, 2024
1 parent 847ef21 commit 1086f36
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 3 deletions.
6 changes: 3 additions & 3 deletions docs/modules/ROOT/pages/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -631,13 +631,15 @@ _This section is non-normative._
* Think through async issues and online failure cases involved in verifying VC/DID document chains.
====

include::partial$version-history.adoc[]

[appendix]
== Open issues / discussion

_This section is non-normative._

Resolve the following topics before producing a 1.0 version of this spec:


* How to express the credential holder’s role in relation to the manifest or specific actions in the manifest? The now-deprecated `stds.schema-org.CreativeWork` assertion offered many options.
** Related: Describe how to allow other assertions to refer to _this_ assertion. (TO DO: Now that the identity assertion is countersigning a list of assertions, is this still necessary?)

Expand Down Expand Up @@ -671,5 +673,3 @@ Resolve the following topics before producing a 1.0 version of this spec:
NOTE: TO DO: Review the following statement adapted from C2PA spec. I think it’s at odds with the use of DID documents, and should likely be removed.

> In most W3C verifiable credential workflows, the information about the subject (e.g., the cryptographic keys) is fetched on demand at the time of validation. While that is an acceptable model, it does open up a possible attack vector by providing an attacker with an externally-visible signal about what the validator is validating. Therefore, this specification also supports having the information captured and embedded at the time of signature. This not only prevents leakage, but also makes it very clear what data the signer is asserting about the credential’s subject.

include::partial$version-history.adoc[]
3 changes: 3 additions & 0 deletions docs/modules/ROOT/partials/version-history.adoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
[appendix]
== Version history

_This section is non-normative._

*27 November 2023*

* Initial private review draft.
Expand Down

0 comments on commit 1086f36

Please sign in to comment.