digital-credentials icon indicating copy to clipboard operation
digital-credentials copied to clipboard

examples or explainability about what might be in the `data` parameters

Open npdoty opened this issue 6 months ago • 1 comments

There has been some confusion about how the Digital Credentials API is actually used in order to select particular properties/claims/credentials. Introduction and examples could be expanded to show how particular credentials and properties could be requested using the API. Some of that will be specific to particular protocols, but a sample would make it a lot clearer to a reader new to the area about what sorts of things are detailed where.

The explainer might be a place to do this, although the explainer is already out of date. So we could either update the explainer, or the introduction/examples section of the spec.

npdoty avatar Jul 09 '25 22:07 npdoty

Based on recent feedback from the TAG (for whom I believe the explainer to be primarily intended, based on their own prior requests) in other WGs, it would be better if we could weave the content of the existing explainer (back?) into (primarily the Introduction section of) the relevant RecTrack documents with which it is associated, and then send the explainer itself to /dev/null. Among other benefits, there would no longer be the need to keep the separate document up to date, although the newly-Introduction-content would still need to be kept current with the content of the other sections.

TallTed avatar Jul 10 '25 23:07 TallTed