Skip to content

Latest versions proposal for leveled specifications

Philippe Le Hegaret edited this page Oct 25, 2017 · 46 revisions

We are implementing the following:

  • /TR/shortname/ed/: editor's draft (outside the /TR space) associated with the document returned by /TR/shortname/
  • /TR/shortname-N/ still points to the latest published version of the level N. /TR/shortnameN/ may be used instead.
  • /TR/shortname/all: generated cover page with list of the different versions
  • /TR/shortname/upcoming/:
    • the latest version of the highest level not obsoleted/rescinded/retired
    • the obsoleted/rescinded/retired document
  • /TR/shortname/latest/: points to the first document in the following list:
    • the highest level being a CR, a PR, or a REC that is not obsoleted or rescinded
    • the highest level being a Note if not retired
    • the lowest level being a WD
    • the obsoleted REC or the rescinded REC
    • the retired Note
  • /TR/shortname/: this is the canonical version of the document, the one referenced by search engines (see rel=canonical'-in-specs). The WG decides whether it should point to the upcoming or latest versions.

Those algorithms are ignoring deprecated drafts (ie drafts that got a new dated version).

This should give enough flexibility to the WGs while normalizing a few links in the TR space.

In terms of redirects, we would have a proxy for /TR/shortname/, /TR/shortname/shortname-n/, /TR/shortname/upcoming/ and /TR/shortname/latest/. Only /TR/shortname/ed/ will actually redirect (307) to the editor's draft. See also List of redirects

Example with the CSP specifications

CSP1 is a Working Group Note. CSP2 is a Recommendation. CSP3 is a Working Draft. This would imply the following latest version links:

  • /TR/CSP/upcoming/ returns the same document as /TR/CSP3
  • /TR/CSP/latest/ returns the same document as /TR/CSP2
  • /TR/CSP/ returns the same document as /TR/CSP/upcoming (following the choice of the Working Group)
  • /TR/CSP/ed/ redirects to the CSP3 editor's draft, ie https://w3c.github.io/webappsec-csp/

Reference: