w3c / vc-data-integrity

W3C Data Integrity Specification
https://w3c.github.io/vc-data-integrity/
Other
41 stars 19 forks source link

Add guidance to recommend usage of DataIntegrityProof pattern. #117

Closed msporny closed 1 year ago

msporny commented 1 year ago

This PR is an attempt to address issue #84 by adding guidance to cryptographic suite authors such that they follow the new DataIntegrityProof pattern.

@silverpill, please let me know if this addresses the concerns you raised in #84. I've tried to address your concerns (in this and other PRs) by:

  1. Cross-linking the other cryptosuite specifications and placing those links at the top of the specification.
  2. Adding a section providing an explanation of the legacy cryptosuites and guidance on what should be used by specification authors for new cryptosuites.
  3. Referencing other cryptosuite specifications in-line in the section that provides guidance to specification authors.

The header that cross-links to all modern cryptosuite specifications is at the top here:

https://w3c.github.io/vc-data-integrity/

... and looks like this:

image


Preview | Diff

msporny commented 1 year ago

Not necessary for merging this PR, but it may still be a good idea to sync this with an update of spec-dir proof table. The latter seems to be outdated with regard to the references listed in the header of this document...

PR raised in https://github.com/w3c/vc-specs-dir/pull/26 ... I can merge as long as someone else (like @iherman) reviews it and approves.