RE: More docs for Pointer Events

Thanks Scott and PhistucK. Here are the new locations:

http://docs.webplatform.org/wiki/dom/PointerEvent

http://docs.webplatform.org/wiki/dom/gotpointercapture

http://docs.webplatform.org/wiki/dom/lostpointercapture

http://docs.webplatform.org/wiki/dom/pointercancel

http://docs.webplatform.org/wiki/dom/pointerdown

http://docs.webplatform.org/wiki/dom/pointerenter

http://docs.webplatform.org/wiki/dom/pointerleave

http://docs.webplatform.org/wiki/dom/pointermove

http://docs.webplatform.org/wiki/dom/pointerout

http://docs.webplatform.org/wiki/dom/pointerover

http://docs.webplatform.org/wiki/dom/pointerup

http://docs.webplatform.org/wiki/dom/initPointerEvent

http://docs.webplatform.org/wiki/dom/setPointerCapture

http://docs.webplatform.org/wiki/dom/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


Just let me know if there are any further corrections I should make.

I also applied to these pages a topic cluster as Scott described, and marked the corresponding MS-prefix pages as deletion candidates with a note.


From: Scott Rowe [mailto:scottrowe@google.com]
Sent: Wednesday, February 20, 2013 8:41 AM
To: PhistucK
Cc: Erika Doyle Navara; public-webplatform@w3.org; Rob Dolin (MS OPEN TECH); Doug Schepers (schepers@w3.org) (schepers@w3.org)
Subject: Re: More docs for Pointer Events

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<mailto: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<mailto: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