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

Re: Recommendation for where to post Pointer Events primer

From: Chris Mills <cmills@w3.org>
Date: Fri, 15 Feb 2013 10:34:17 +0000
Cc: "public-webplatform@w3.org" <public-webplatform@w3.org>, "Doug Schepers (schepers@w3.org)" <schepers@w3.org>
Message-Id: <B14DFB0F-F94B-40F1-B2FA-04062082E82B@w3.org>
To: "Rob Dolin (MS OPEN TECH)" <robdolin@microsoft.com>
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 10:34:28 UTC

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