search

w3c-fedid / FedCM

A privacy preserving identity exchange Web API
https://w3c-fedid.github.io/FedCM/
Other
383 stars 73 forks source link

Explainer is out of date. Should we remove it? #622

Closed samuelgoto closed 2 months ago

samuelgoto commented 4 months ago

We wrote a series of explainers over the years, but most of them are fairly out of date at this point, as @yoavweiss noted here https://github.com/fedidcg/FedCM/issues/621#issuecomment-2206130679.

The spec is certainly up to date with Chrome's implementation, but it is probably harder to read than what we'd want to point developers too.

Chrome's developer documentation is also up to date, but we probably want something Chrome-agnostic.

MDN's developer documentation is chrome-agnostic, but not as up to date as Chrome's.

We should probably remove the explainer (or at least mark it as out of date), but that leaves us the question: where should we point developers to?

npm1 commented 4 months ago

MDN is pretty good for more settled pieces, and usually the other parts are chrome-specific so the Chrome documentation is fine.

samuelgoto commented 4 months ago

MDN is pretty good for more settled pieces

Yeah, I'm wondering if we should invest more into making the MDN article really good.

aaronpk commented 4 months ago

The MDN article was the most helpful thing I found when i was spinning up on this. Seems like a good resource to continue to maintain.