W3C home > Mailing lists > Public > public-webplatform@w3.org > December 2014

Re: Compatibility Notes

From: PhistucK <phistuck@gmail.com>
Date: Thu, 4 Dec 2014 21:38:01 +0200
Message-ID: <CABc02_+rxuezvikQ5ecoxbDDPC-p7s+cPGm83TxghSKzrbeibg@mail.gmail.com>
To: Renoir Boulanger <renoir@w3.org>
Cc: List WebPlatform public <public-webplatform@w3.org>
But these are compatibility notes, with specific versions... They will
never be outdated. Anyone can be using an old version (unfortunately).
For example -
Chrome 39 and earlier - the parameter is optional.
This note makes you understand that even though this browser accepts this
practice, it is wrong and incompatible.

How do you imagine the standard way of reflecting this information would be
in the future?
Using tests? Will every browser version go through testing and the entire
information would be presented?
How can it be presented in a way that is meaningful, straightforward and
comprehensible to the reader?


On Wed, Dec 3, 2014 at 7:22 PM, Renoir Boulanger <renoir@w3.org> wrote:

> Hi,
> I just realized that nobody replied to this yet, sorry about the delay.
> On 2014-11-30 3:46 AM, PhistucK wrote:
> > Following a bug fix (required arguments were optional) in Chrome, I
> wanted
> > to add a compatibility note to
> > https://docs.webplatform.org/wiki/dom/Document/createCDATASection, but I
> > cannot find any "Compatibility notes" section in the form anymore.
> > Is that intentional?
> Compatibility notes is like a bucket where we put things we aren’t sure
> where to sort.
> Eventually we might have more efficient to show compat data and its
> progress over time.
> > If so, where is the appropriate place for such notes from now on?
> >
> > ☆*PhistucK*
> Maybe we should re-think how we organize that particular information.
> In the end, those notes are "todays’s recipe" of something that will
> eventually be outdated practice.
> Remember how long the clearfix div we were adding when we should use
> `overflow:hidden` on float parent.
> I have a suggestion.
> How about we use the "Notes section" at the "Usage (optional)" and
> reframe it to link to a tutorial.
> --
> Renoir Boulanger    http://www.w3.org/People/#renoirb
> @renoirb                 https://renoirboulanger.com/
> World Wide Web Consortium (W3C)    http://www.w3.org/
Received on Thursday, 4 December 2014 19:39:08 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:14:09 UTC