Update MSE info to handle levels 1, 2 and latest version #769
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
When MSE was published as a REC, it did not have levels. That changed. The unversioned URL now targets Level 2, which is not the Rec. This update renames the shortname of the Rec from `media-source` to `media-source-1`, updates the URL for that level to `https://www.w3.org/TR/media-source-1/`, and creates a `media-source` alias to turn the `media-source` entry into a "current version" URL. Specs that currently use `[[MEDIA-SOURCE]]` to reference MSE will now target the level 2 WD and not the level 1 Rec, but then they were targeting the Rec with the URL of WD, so the reference was clumsy in any case. All of these specs are in the Media WG in any case (except HTML, but HTML references the Editor's Draft, so nothing changes there...). Note that there is no generic mechanism in Specref to handle such series. Some discussion in tobie#463.
dontcallmedom
approved these changes
Dec 5, 2023
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
When MSE was published as a REC, it did not have levels. That changed. The unversioned URL now targets Level 2, which is not the Rec. The
media-sourceentry in Specref is confusing as a result because it claims the spec is a Rec but links to the WD.This update renames the shortname of the Rec from
media-sourcetomedia-source-1, updates the URL for that level tohttps://www.w3.org/TR/media-source-1/, and creates amedia-sourcealias to turn themedia-sourceentry into a "current version" URL.Specs that currently use
[[MEDIA-SOURCE]]to reference MSE will now target the level 2 WD and not the level 1 Rec. All of these specs are in the Media WG, and the update is precisely meant to avoid having to update these references in the source code of these specs. HTML also references MSE but it references the Editor's Draft in any case, so nothing is going to change there...Note that there is no generic mechanism in Specref to handle such series. Some discussion in #463.