This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
| spec:shortnames [2012/09/05 14:33] – [Unversioned Names] fantasai | spec:shortnames [2012/09/06 08:32] – [Versioned Names] Added option c tabatkins | ||
|---|---|---|---|
| Line 3: | Line 3: | ||
| This page is to record our policy for CSS module shortnames going forward and a plan for converting all existing shortnames to match this scheme. A shortname is used as the filename on /TR and dev.w3.org and also as the [spec-code] in www-style discussions. The existing scheme was set up in the 20th century, before the concept of independently-levelling CSS modules was created. | This page is to record our policy for CSS module shortnames going forward and a plan for converting all existing shortnames to match this scheme. A shortname is used as the filename on /TR and dev.w3.org and also as the [spec-code] in www-style discussions. The existing scheme was set up in the 20th century, before the concept of independently-levelling CSS modules was created. | ||
| - | ==== Unversioned Names ==== | + | ===== Unversioned Names ===== |
| Each module will have an unversioned shorname on /TR, which aliases to the latest level. This is identical to the module shortname, except without the number, e.g. '' | Each module will have an unversioned shorname on /TR, which aliases to the latest level. This is identical to the module shortname, except without the number, e.g. '' | ||
| Line 9: | Line 9: | ||
| **Issue:** Do we want to set this up on dev.w3.org as well? As alias or redirect? | **Issue:** Do we want to set this up on dev.w3.org as well? As alias or redirect? | ||
| - | **Issue:** At what point in the process does the shortname move over? | + | **Issue:** At what point in the process does the shortname move over to the next level? |
| * Option A = CR | * Option A = CR | ||
| * Option B = Snapshot acceptance | * Option B = Snapshot acceptance | ||
| * Option C = REC | * Option C = REC | ||
| - | ==== Versioned Names ==== | + | ===== Versioned Names ===== |
| Each module will have a versioned shortname on /TR, for accessing a specific level of the module. Currently we use '' | Each module will have a versioned shortname on /TR, for accessing a specific level of the module. Currently we use '' | ||
| Line 23: | Line 23: | ||
| * Republishing at '' | * Republishing at '' | ||
| * Setting up a temporary redirect from '' | * Setting up a temporary redirect from '' | ||
| + | * Unsolicited feedback from several authors indicates that this pattern is confusing, because of the connection with general " | ||
| == Option B == | == Option B == | ||
| Line 29: | Line 30: | ||
| * Moving all specs to '' | * Moving all specs to '' | ||
| * Setting up permanent redirects from '' | * Setting up permanent redirects from '' | ||
| + | * This model is already used by Selectors, and several WebApps specs. | ||
| + | == Option C == | ||
| + | |||
| + | Slight variation on Option B: follow '' | ||
| + | * Moving all specs to '' | ||
| + | * Setting up permanent redirects from '' | ||
| + | * This might be more readable. | ||