Check references category and stability #295
Comments
tidoust
added a commit
to tidoust/presentation-api
that referenced
this issue
May 13, 2016
|
|
tidoust |
7cfd529
|
tidoust
referenced
this issue
May 13, 2016
Merged
Fix link to WebIDL "throw", update ref to WebIDL to target Second Level #296
mfoltzgoogle
added a commit
that referenced
this issue
May 26, 2016
|
|
tidoust + mfoltzgoogle |
b67ca69
|
anssiko
added the
v1
label
Sep 7, 2016
tidoust
pushed a commit
to tidoust/presentation-api
that referenced
this issue
Jan 10, 2017
|
|
65928d2
|
tidoust
referenced
this issue
Jan 10, 2017
Merged
Issue #396: Migrate HTML 5.0 references to HTML 5.1 #404
mfoltzgoogle
added a commit
that referenced
this issue
Jan 11, 2017
|
|
tidoust + mfoltzgoogle |
4df5120
|
|
I believe the Presentation API now references stable published specifications whenever possible. One remaining open question: can the Presentation API simply reference the latest version of WebIDL, even though it is not in a stable state, or should the Presentation API spec continue to reference both WebIDL Level 1 and WebIDL Level 2 to point out all WebIDL terms used in the spec are defined in Level 1 except I'll try to come up with an answer (needed before requesting transition to Proposed Recommendation, not needed for publication as Candidate Recommendation). |
|
Can this be closed now @tidoust? All of the sub-tasks have been addressed. |
|
Closing this issue since all updates were made to the spec, see follow-up issue #408 on reference to WebIDL. |
tidoust commentedMay 13, 2016
•
edited
I'm creating this issue to track down references. It does not need to be addressed before publication as a Candidate Recommendation.
For the Presentation API to be published as a final W3C Recommendation, normative references will need to reference stable specs, the rule of thumb being that a Recommendation should normatively link to other Recommendations (or similar documents published by other organizations) and not to working drafts.
There may be exceptions to the rule, which should be documented in the Status of This Document section. For instance, since WebIDL is not yet a Recommendation, recently published specs have sentences such as "By publishing this Recommendation, W3C expects the functionality specified in this Recommendation will not be affected by changes to Web IDL as the WebIDL specification proceeds to Recommendation." as in the Web Storage spec:
http://www.w3.org/TR/2016/REC-webstorage-20160419/#status-of-this-document
Also, we need to ensure that references are correctly flagged as normative or informative, depending on how they get used in the spec.
Making a quick pass through the spec:
NotAllowedError, defined in WebIDL (Second Level) but not in WebIDL Level 1Blob, defined in the File API spec