Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Appendix 1 to be consistent with the latest snapshot of the Digital Credentials API #264

Open
samuelgoto opened this issue Sep 16, 2024 · 6 comments

Comments

@samuelgoto
Copy link
Contributor

There are at least 2 PRs (this and this) that were merged (or are under review) after Appendix 1 was written and merged, making the current snapshot out of date.

We know that time is of the essence here, so @marcoscaceres and I are trying to get all known breaking changes merged before TPAC ends next week.

Would it be possible to update Appendix 1 once those changes get merged?

I'm only aware of this and this, and we are trying to avoid backwards incompatible changes as much as we possibly can, but wanted to get a sense of what process we should follow and align our expectations on timelines, hence asking here.

@jogu jogu added this to the Final 1.0 milestone Sep 16, 2024
@marcoscaceres
Copy link
Contributor

Note that on the W3C side, we reserve the right to change whatever we want... this is an incubation after all. As @samuelgoto notes, we are being careful not to make backwards incompatible changes. At the same time, the WICG spec has no official standing and it's literally an "incubation" (as it states in the Status section: "This is an unofficial proposal.").

We warn in the README that:

🚧 Note: The API is still extremely unstable and undergoing a lot of changes (almost daily!). 🚧

(We should add that to the spec too)

And, as is stated in all W3C specifications during working draft phase:

This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

@bc-pi
Copy link
Member

bc-pi commented Sep 16, 2024

Noting the difficulties and disclaimers of working across SDOs with disparate timelines, it would be good to be as consistent as the given situation allows. I've had a mental todo to chase that down once those get merged. But I forget stuff. So thanks @samuelgoto for making it explicit.

Would it be possible to update Appendix 1 once those changes get merged?

I believe so, yes. Feel free to put in a PR. Or nudge me to do it.

@bc-pi
Copy link
Member

bc-pi commented Sep 18, 2024

WICG/digital-credentials#164 has been merged

@bc-pi
Copy link
Member

bc-pi commented Sep 19, 2024

WICG/digital-credentials#165 has also been merged

@bc-pi
Copy link
Member

bc-pi commented Sep 19, 2024

and WICG/digital-credentials#170 "Update example to show feature detection" seems potentially relevant

@Sakurann
Copy link
Collaborator

Sakurann commented Dec 5, 2024

has this been resolved with #254 ? closing in a week unless objections.

@Sakurann Sakurann removed this from the Final 1.0 milestone Dec 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

5 participants