W3C home > Mailing lists > Public > public-webplatform@w3.org > April 2013

Re: Caniuse features missing articles on WebPlatform Docs

From: Mike Sierra <letmespellitoutforyou@gmail.com>
Date: Mon, 29 Apr 2013 10:38:09 -0400
Message-ID: <CAECD241DOrWFEf+S_kw9b5sOHCz+vhOn96m95eJnndZa5Lu-Og@mail.gmail.com>
To: Alexis Deveria <adeveria@gmail.com>
Cc: Doug Schepers <schepers@w3.org>, "public-webplatform@w3.org" <public-webplatform@w3.org>
OK on Doug's tutorials distinction, but I think at least a few features are
also well covered in existing ref doc:

* "SVG in CSS backgrounds" :: css/properties/background-image :: feature
  is explicitly listed in compatibility table

* "CSS3 Background-image options" :: css/properties/background-image
  :: refers to >1 image, various background-position, -size, -origin,
  -clip, -attachment properties, which appear well doc'ed on each property

I think these should be covered on existing pages, but those pages may
need to be enhanced:

* "SVG in HTML img element" :: html/elements/img :: currently uses
  .svg example, but s/b explicit in compat. table

* "rem (root em) units" :: css/units/length :: add compat. table

* "Viewport units: vw, vh, vmin" :: css/units/length :: add compat. table

* "New semantic elements" :: html/elements/section,
  html/elements/article, html/elements/figure, etc. :: Many of these
  pages need sprucing up, but are any missing?

* "SVG effects for HTML" :: css/properties/filter :: add
  url(file.svg#filter) syntax to compat table; but note this only
  concerns SVG filters portion of that feature bag, not SVG's
  foreignObject tag, which is missing from ref doc

And clearly these need new pages:

* "Toolbar/context menu" :: html/elements/menu, dom/events/contextmenu
  already exist :: s/b new html/elements/command

* "SVG SMIL animation" :: svg/elements tree is missing animate,
  animateColor, animateMotion, animateTransform, & set tags

* "Touch events" :: dom/events missing touchstart, touchend,
  touchmove, touchleave, touchcancel

I left out a bunch of other features from the original list that also
would need new pages, but note that many require nouns not
accounted for in the existing content tree:

* HTTP headers
* file formats
* URI schemes
* URI fragment syntax

(Perhaps make room for the media fragments URI feature
http://www.w3.org/TR/media-frags, which is similar to SVG viewBox

--Mike S

On Sun, Apr 28, 2013 at 11:12 PM, Alexis Deveria <adeveria@gmail.com> wrote:

> Yeah, there's a couple of features I've found that have good matching
> tutorials, but not reference pages. I'll see if I can update the page with
> those that are missing them.
> And yes, Doug, adding multiple links when there's multiple related pages
> definitely makes sense, thanks.
> Alexis
> On Sun, Apr 28, 2013 at 4:27 PM, Doug Schepers <schepers@w3.org> wrote:
>> Hi, Mike-
>> I think the goal is to point to the reference pages, not just tutorials
>> (though both are good). So, until we have reference pages for those
>> articles, I'd like to keep those items on the list.
>> Regards-
>> -Doug
>> On 4/28/13 10:48 AM, Mike Sierra wrote:
>>> I think in some cases the caniuse categories are too broad ("new
>>> semantic elements") and sometimes too specific ("rem") to justify
>>> separate pages. So I don't think we're missing all that much.
>>> I added some SVG tutorials recently, & can mark these covered:
>>> * "SVG SMIL animation" Covered here:
>>> http://docs.webplatform.org/**wiki/svg/tutorials/smarter_**svg_animation<http://docs.webplatform.org/wiki/svg/tutorials/smarter_svg_animation>
>>> * "SVG effects for HTML" Light coverage of foreignObject (embed HTML
>>>    within SVG), but full coverage for SVG filters within HTML here:
>>> http://docs.webplatform.org/**wiki/svg/tutorials/smarter_**svg_filters<http://docs.webplatform.org/wiki/svg/tutorials/smarter_svg_filters>
>>>    (Currently works in Mozilla, even animated; partial WebKit coverage)
>>> --Mike S
>>> On Sat, Apr 27, 2013 at 9:54 PM, Doug Schepers <schepers@w3.org
>>> <mailto:schepers@w3.org>> wrote:
>>>     Hi, Alexis-
>>>     On 4/27/13 7:58 PM, Alexis Deveria wrote:
>>>         Hi all, I recently started to add links to WPD articles for
>>>         caniuse.com <http://caniuse.com>
>>>         <http://caniuse.com>,
>>>     That is awesome in and of itself!
>>>         and came across a number that don't yet have
>>>         related WPD pages. I figured people here might find it useful to
>>>         know of
>>>         this list, so I've added it as a user subpage here:
>>>         http://docs.webplatform.org/__**wiki/UserWiki:Adeveria/__**
>>> caniuse-missing<http://docs.webplatform.org/__wiki/UserWiki:Adeveria/__caniuse-missing>
>>>         <http://docs.webplatform.org/**wiki/UserWiki:Adeveria/**
>>> caniuse-missing<http://docs.webplatform.org/wiki/UserWiki:Adeveria/caniuse-missing>
>>> >
>>>         Hope this is helpful as an indicator of what kind of things
>>>         don't yet
>>>         have pages, though I understand it doesn't make sense for each
>>>         entry to
>>>         have a page.
>>>     This is a great list, very useful. We should prioritize adding those
>>>     pages. Please keep the list coming!
>>>     I agree with the ones you mark as unspecific, but even those could
>>>     have landing pages with the collection of links to the specific
>>>     articles (or perhaps you can add multiple links to WPD for those?).
>>>     Does anyone want to step up to start populating the pages on this
>>>     list, even as stubs? I'd be happy to get someone started.
>>>     Regards-
>>>     -Doug
Received on Monday, 29 April 2013 14:38:40 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:13:46 UTC