Re: Dealing with levels in specs

On 11/18/2016 07:07 PM, Tab Atkins Jr. wrote:
>
> Like, my personal preference would be URL structures that are
> automatically shaped like:
>
> /TR/foo-1 <= the level 1 of the foo spec
> /TR/foo-2 <= the level 2 of the foo spec
> /TR/foo   <= the ED of the foo spec
>
> Or, if we wanted to enforce a little more separation between legal-TR
> and ED, this would also work:
>
> /TR/foo-1 <= level 1
> /TR/foo-2 <= level 2
> /TR/foo   <= level 2 right now, shifts if level 3 gets published
> /TR/foo/latest <= ED, or with some similar sort of URL pattern
>
> Right now the CSSWG manually requests the latter structure when we
> publish (and some things are inconsistent as a result), except our EDs
> are on a different server altogether.

I'd like to close the gap on ED->TR such that there is no need for anyone
other than the editor and the people reviewing the editor's latest set of
changes for correctness to look at the ED. We've made a lot of progress
towards that this year by having automated publishing for WDs. CSSWG
still needs to push updates to many of its drafts, and then set them up
for push-button publishing so that they can stay up-to-date, with changes
pushed to /TR immediately after the corresponding WG resolution. But once
that happens, it should no longer be necessary for most people to reference
the EDs.

As for what to do with EDs, I'd like to have an ED for each thing that's
published on /TR so that when I need to make a set of changes to any one
of them, I can point people to a public URL for said review. :) It's not
good enough to have one ED for multiple levels, as they are different
documents, and we frequently have more than one level actively maintained
at any given point. (E.g. one level is CR, and accepting fixes based on
implementation feedback, while one level is WD and churning as we design
new features.)

So my preferred URL structure would be like the first one:

/TR/foo-1 <-- level 1 functionality, most up-to-date copy that anyone
               other than my co-contributors should be looking at
/TR/foo-2 <-- level 2 functionality, most up-to-date copy that anyone
               other than my co-contributors should be looking at
/TR/foo   <-- internal redirect to whatever level WG considers "stable"
               or alternately a disambiguation page

EDs could be hosted on a separate server or mirrored on /TR or given
/TR/foo-1/ed redirects/proxies/whatever--I don't particularly care.
Their purpose is to be a publicly shared copy of whatever I'm currently
working on in whatever state of order or disarray it happens to be, and
only people who are helping me with currently-tasked edits should need
to know where they are.

~fantasai

Received on Thursday, 24 November 2016 06:25:33 UTC