W3C home > Mailing lists > Public > public-secondscreen@w3.org > April 2015

Re: Proper sources for cross-references?

From: Kostiainen, Anssi <anssi.kostiainen@intel.com>
Date: Thu, 30 Apr 2015 12:49:52 +0000
To: "mark a. foltz" <mfoltz@google.com>, Francois Daoust <fd@w3.org>
CC: "public-secondscreen@w3.org" <public-secondscreen@w3.org>, "Rottsches, Dominik" <dominik.rottsches@intel.com>
Message-ID: <FD27DBFD-24B6-434D-86C5-302D568D9686@intel.com>
Hi Mark,

> On 29 Apr 2015, at 23:27, mark a. foltz <mfoltz@google.com> wrote:
> 
> The current cross reference database seems to use "bleeding edge" references for things like DOM [1] and WebIDL [2] hosted on GitHub.  This introduces a bit of complexity when editing the spec because some of the definitions for things like DOMException have moved from DOM to WebIDL in the bleeding edge versions, but not the published versions.   And the cross reference for the DOMException definition [3] seems to have gotten stale.
> 
> Questions:
> 
> (1) Should we be cross referencing bleeding edge or published versions of specs?

We should be able to reference the bleeding edge specs in Editor's Draft without problems. Later when we enter more stable stages, having unstable references may become an issue.

I'll let Francois expand on the W3C's current take on references.

> (2) If the answer to (1) is "bleeding edge", should we fix up the cross references list (or, better, adopt or sync with one that someone else maintains)?

Thanks,

-Anssi


> [1] https://dom.spec.whatwg.org/
> [2] http://heycam.github.io/webidl/
> [3] https://dom.spec.whatwg.org/#domexception
> 
> 
Received on Thursday, 30 April 2015 12:50:32 UTC

This archive was generated by hypermail 2.3.1 : Thursday, 30 April 2015 12:50:32 UTC