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

Define "Grace Period" and "can reasonably assume are still a part of the web... #288

tantek opened this Issue May 11, 2018 · 2 comments


None yet
2 participants
Copy link

commented May 11, 2018

The Confluence Metrics graphs are quite interesting! It would be great if the "Grace Period" could be better defined, in particular, how do you qualify the start of a grace period?

Is it when the defining standard reaches a certain level of document maturity? E.g. W3C Recommmendation or at least Candidate Recommendation?

Or given the qualification "can reasonably assume are still a part of the web platform", is it based on there existing some number of Web Platform Tests for the API, and 2+ browsers passing them (in the same way)?

Either way it would be great to have a (at least somewhat) measurable / objective criteria, especially since the graphs make it look like the data is quite precise.

Thank you for providing such a great resource!

(Originally published at:


This comment has been minimized.

Copy link

commented May 15, 2018

Grace Period is explicitly defined here. For example, an API contributes to the "Browser-Specific" count for Browser X on Date D iff:

  1. All releases of Browser X from Date D to Date D-1year include the API
  2. All releases of other browsers (not Browser X) from Date D to Date D-1year do not include the API

@mdittmer mdittmer closed this May 18, 2018


This comment has been minimized.

Copy link

commented Jun 6, 2018

I should have been more clear, it would be great if the Confluence Metrics graphs UI itself linked to the definition so it was more easily discoverable.

I.e. by putting a span with an ID on the definition of "Grace Period" in the README, and then linking to that fragment from the web UI, by hyperlinking the first instances of "Grace Period" (with quotes) appearing in the div class="text-content" elements in

I started a pull request at #303 but figured you may have a more preferred method / markup for this.

Thanks for your consideration!

(Originally published at:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.