ecmarkup icon indicating copy to clipboard operation
ecmarkup copied to clipboard

Suggestion: add metadata field for marking a proposal as outdated / merged into upstream spec

Open mathiasbynens opened this issue 3 years ago • 2 comments

For proposals that have reached stage 4, it seems worthwhile to show a big warning banner at the top of the rendered spec text, urging folks to no longer reference the proposal itself but instead link to the integrated version into the spec text. Something like this (but with better phrasing):

Note: This proposal has been accepted into the upstream ECMAScript specification — please update your references to point there. This snapshot is only kept for historical purposes.

For styling inspiration, here's a similar example for a CSS spec: https://drafts.csswg.org/date/2018-07-09T23:26:30/css-box-3/

Currently, proposal authors can manually implement something like this, but it would be helpful if there was a standard mechanism to accomplish this.

We could either introduce a new metadata field (maybe deprecated: true?), or we could do this automatically when both status: proposal and stage: 4 are set in the metadata.

cc @tc39/ecma262-editors

mathiasbynens avatar Aug 10 '20 05:08 mathiasbynens

I've manually added an example to the Promise.any proposal: https://tc39.es/proposal-promise-any/

mathiasbynens avatar Aug 10 '20 05:08 mathiasbynens

Doing it automatically sounds perfect; nothing at stage 4 is ever not going to need this warning.

ljharb avatar Aug 10 '20 05:08 ljharb