-
Notifications
You must be signed in to change notification settings - Fork 142
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
Consider supporting entries for specification series #811
Comments
The `encrypted-media` entry was an alias of `encrypted-media-1`, but the series shortname should now redirect to `encrypted-media-2`. Unfortunately, this means adding a bunch of aliases to preserve previous dated entries. That's slightly ugly (although easy to prepare with a good text editor that supports multi-line edits) but there's no real better way until Specref understands series shortnames (tracked in #811).
My suggestion would be to have the dated versions tied to the unversioned entry, so: |
In the |
Fair point. |
Via discussion in #810 (comment)
Various specs in W3C come in levels that belong to the same series. Both levels and series have shortnames in W3C, but the series shortname is more to be seen as a way to redirect to the "current" level (which evolves over time). For example:
css-fonts-3
,css-fonts-4
,css-fonts-5
all belong to thecss-fonts
series. As the time of writing, the current spec iscss-fonts-4
.Levels may be created after a first iteration on a spec. For example,
media-source-1
was known asmedia-source
until level 2 got created.media-source
is now the shortname of the underlying series, the current spec beingmedia-source-2
.Specref does not have the concept of series. That means no entry for
css-fonts
, and no easy way to "follow" the current specification in the latter case, requiring clunky workarounds, as done in #810. It would be great to support series shortnames more directly in Specref.The end goal would be to make it easy to reference a spec by:
css-fonts
, in which case the reference goes to the latest version of the current level in the series.css-fonts-5
, in which case the reference goes to the latest version of that level.css-fonts-4-20240201
in which case the reference goes to the specified version. The dated version typically includes the level, we should not need to create or use acss-fonts-20240201
entry!Adding support for series requires switching the W3C update script to the W3C API, because
tr.rdf
does not know anything about series either.Note the need to preserve past dated versions in the case where the level gets introduced afterwards (e.g.
media-source-20140717
needs to exist even though themedia-source
spec is now known asmedia-source-1
). Also note that some specs start without a level, then get a level, and then get back to a no-level mode...(I don't think the notion of specification series exists in other SDOs, although that could perhaps be useful to track versions of ETSI and ISO specs longer term)
The text was updated successfully, but these errors were encountered: