Explainer is out of date. Should we remove it?

[samuelgoto]

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 #621 (comment).

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]

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

[samuelgoto]

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]

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.