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

RE: Recommendation for where to post Pointer Events primer

From: Rob Dolin (MS OPEN TECH) <robdolin@microsoft.com>
Date: Fri, 15 Feb 2013 21:22:04 +0000
To: Chris Mills <cmills@w3.org>
CC: "public-webplatform@w3.org" <public-webplatform@w3.org>, "Doug Schepers (schepers@w3.org)" <schepers@w3.org>
Message-ID: <0aa1ef7acd034ea5a71307794200c4e7@BN1PR03MB008.namprd03.prod.outlook.com>
Thanks very much Chris.  :)

I appreciate your advice and have started publishing as a "concept" at: http://docs.webplatform.org/wiki/concepts/PointerEvents.

'All the best--
--Rob

-----Original Message-----
From: Chris Mills [mailto:cmills@w3.org] 
Sent: Friday, February 15, 2013 2:34 AM
To: Rob Dolin (MS OPEN TECH)
Cc: public-webplatform@w3.org; Doug Schepers (schepers@w3.org)
Subject: Re: Recommendation for where to post Pointer Events primer

Hi Rob! Welcome to the list ;-)

>From your outline, it looks like it's gonna be a kind of extended concept example, rather than a tutorial (unless of course, you're gonna get the reader to build the code themselves step by step, in which case it would be a tutorial.)

So I would create it a concept - we decided a little while ago that there was no point having concepts AND guides, as they do basically the same thing. And we liked concepts better.

Create it as something like "pointer events fundamentals" or "pointer events explained" using the concepts form field.

Eventually, we should create an "API learning material" topic at http://docs.webplatform.org/wiki/apis, and link to your pointer events concept article from there.

Hope this helps.

Chris Mills
Opera Software, dev.opera.com
W3C Fellow, web education and webplatform.org Author of "Practical CSS3: Develop and Design" (http://goo.gl/AKf9M)

On 14 Feb 2013, at 23:41, "Rob Dolin (MS OPEN TECH)" <robdolin@microsoft.com> wrote:

> Hi all,
>     My name is Rob Dolin and this is my first post to the list.  I've been drafting a "Primer" doc for Pointer Events [1] and Doug (CC'd) suggested I pose this question to the mailing list:
>  
>     I was looking at the New Page Form [2] and I'm wondering if I 
> should post the Pointer Events Primer as a "Guide" or as a "Tutorial."  
> (Below is an outline of the content I'm in the process of writing.)
>  
>     Thanks very much-
> --Rob
>  
> [1] http://www.w3.org/2012/pointerevents/
> [2] http://docs.webplatform.org/wiki/WPD:New_Page
>  
> Pointer Events Primer (Outline)
> 1              Goals
> 2              Why Pointer Events
>                 2.1          Unified model for Multiple input types
>                 2.2          Ability to Identify Different Input Types
>                 2.3          Additional Methods and Attributes
> 3              Basic Pointer Events
>                 3.1          Down and Up (with example)
>                 3.2          Move (with example)
>                 3.3          Over and Out (with example)
>                 3.4          Enter and Leave (with example)
>                 3.5          Cancel
>                 3.6          Comparison of Mouse Events and Pointer Events
> 4              Pointer Event Attributes
>                 4.1          PointerType
>                 4.2          PointerId
>                 4.3          IsPrimary
>                 4.4          Contact Geometry Width and Heigh
>                 4.5          Pressur
>                 4.6          Pen TiltX and TiltY
> 5              Multiple Pointers At Once / Multi-Touch (with example)
> 6              Detecting Which Button(s) Are Pressed
> 7              Try Pointer Events Today with Early Implementations
>                 7.1          WebKit with Pointer Events Patch
>                 7.2          Internet Explorer 10
> 8              Further Reading
> 9              Appendix A: Designing for Touch
> 10           Appendix B: Pointer Capture
>                 10.1        Slider Control Example
>                 10.2        SetPointerCapture method and GotPointerCapture event
>                 10.3        ReleasePointerCapture method and LostPointerCapture event
>  
>  
>  
> Rob Dolin
> Senior Program Manager and Technical Diplomat Microsoft Open 
> Technologies, Inc.
> A subsidiary of Microsoft Corporation
>  
Received on Friday, 15 February 2013 21:23:22 UTC

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