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

Re: More docs for Pointer Events

From: Scott Rowe <scottrowe@google.com>
Date: Wed, 20 Feb 2013 08:40:52 -0800
Message-ID: <CAHZLcPqTGxDt__MRQNFdkDZffGSkXjTXMiYadr1Dn=mssC8+tg@mail.gmail.com>
To: PhistucK <phistuck@gmail.com>
Cc: Erika Doyle Navara <Erika.Doyle@microsoft.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>, "Rob Dolin (MS OPEN TECH)" <robdolin@microsoft.com>, "Doug Schepers (schepers@w3.org) (schepers@w3.org)" <schepers@w3.org>
To what PhistucK says, yes, that's my understanding, too. But if you run
into any naming conflicts, just use a suffix for one of the duplicates,
i.e. "/dom/pointercancel_event" or "/dom/pointercancel_method".

We haven't yet audited the DOM section thoroughly. It's on the list.

To  "group" together all of the pointer events-related doc, we've got just
the ticket. All you have to do is check the box under Topic Clusters in the
See Also section of the template. I've added the Pointer Event topic
cluster item. But, be careful with this. You only need to check the box for
the dom/PointerEvent object page, not the sub pages for each object member.
I wish I could advise you to follow suit for the dom/pointercancel,
dom/pointerdown, etc., but since there is no listing page for these that
encapsulates them all, each must have the Pointer Events topic cluster
checkbox checked.

Note to self (and every one), we need to be able to categorize related DOM
events - like these "pointer" events; methods, too. Our current structure
does not allow this. Also, shouldn't our DOM structure follow the actual
DOM structure, i.e. /dom/Window and so on?

I confess, I'm not up to speed on the DOM docs structure. Maybe Julee can
chime in here.

+Scott



On Tue, Feb 19, 2013 at 10:46 PM, PhistucK <phistuck@gmail.com> wrote:

> Thank you for doing this.
>
> The URLs are wrong, though.
> There was a consensus about not having "/events", "/objects", "/methods",
> "/properties" in the URL. I know the DOM section has not been totally (or
> even a little) updated yet, but that is the new URL structure we should use
> when creating new pages, I believe.
>
> Please, correct me if I am wrong.
>
> The CSS "/properties" should be kept, though.
>
> ☆*PhistucK*
>
>
> On Wed, Feb 20, 2013 at 3:43 AM, Erika Doyle Navara <
> Erika.Doyle@microsoft.com> wrote:
>
>> Hi all,
>>
>> I'm new to WPD community (and am still waiting on my list subscription to
>> process!), but have been working these past few days with Doug and Rob
>> Dolin to prepare Pointer Events docs in preparation for this week's W3Conf.
>>
>> I created a set of new (unprefixed) reference pages for pointer events
>> [1], and attempted to summarize and combine the relevant information from
>> the latest version of the spec and the MS-prefix pages imported from MSDN.
>> If these new pages seem suitable, I was thinking the best approach might be
>> to mark the original MS-prefix pointer events pages as "Deletion
>> Candidate". Does that sound okay?
>>
>> Another question I had was if there is a standard way to somehow "group"
>> together all of the pointer events-related docs? For now, I just added
>> inter-wiki links to the related ref docs under the "See also" sections.
>>
>> Any advice / feedback / corrections would be most welcome!
>>
>> Thanks,
>> Erika Navara
>>
>> [1]
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/height
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/isPrimary
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/pointerId
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/pointerType
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/pressure
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/tiltX
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/tiltY
>> http://docs.webplatform.org/wiki/dom/objects/PointerEvent/width
>> http://docs.webplatform.org/wiki/dom/events/gotpointercapture
>> http://docs.webplatform.org/wiki/dom/events/lostpointercapture
>> http://docs.webplatform.org/wiki/dom/events/pointercancel
>> http://docs.webplatform.org/wiki/dom/events/pointerdown
>> http://docs.webplatform.org/wiki/dom/events/pointerenter
>> http://docs.webplatform.org/wiki/dom/events/pointerleave
>> http://docs.webplatform.org/wiki/dom/events/pointermove
>> http://docs.webplatform.org/wiki/dom/events/pointerout
>> http://docs.webplatform.org/wiki/dom/events/pointerover
>> http://docs.webplatform.org/wiki/dom/events/pointerup
>> http://docs.webplatform.org/wiki/dom/methods/initPointerEvent
>> http://docs.webplatform.org/wiki/dom/methods/setPointerCapture
>> http://docs.webplatform.org/wiki/dom/methods/releasePointerCapture
>> http://docs.webplatform.org/wiki/dom/navigator/pointerEnabled
>> http://docs.webplatform.org/wiki/dom/navigator/maxTouchPoints
>> http://docs.webplatform.org/wiki/css/properties/touch-action
>>
>>
>>
>>
>
Received on Wednesday, 20 February 2013 16:41:25 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:57:39 UTC