RE: Recommendation for where to post Pointer Events primer

On 2/18/13 5:00 AM, ext PhistucK wrote:
> On Mon, Feb 18, 2013 at 2:32 PM, Arthur Barstow <art.barstow@nokia.com> wrote:
>> Given this, it seems like WPD should document the events in the LC spec rather than their ms* equivalents e.g. see <http://docs.webplatform.org/wiki/dom/events>. WDYT?

Rob's primer [1] uses unprefixed events in sample code and provides a table of the prefixed names for IE10, which I think is appropriate. For the API docs, it might be beneficial to have both versions (perhaps just symlinks of a single set of docs with a similar table?). While I agree with PhistucK about there not being shipping unprefixed implementations yet, having both documented might help for SEO.
[1]   http://docs.webplatform.org/wiki/concepts/PointerEvents


> WebKit does not seem to be in favor of this method, for example.
It's fair to say there's not complete consensus  in the WebKit community yet. But many WebKit community members are favorable.  


From: PhistucK [mailto:phistuck@gmail.com] 
Sent: Monday, February 18, 2013 5:00 AM
To: Arthur Barstow
Cc: Rob Dolin (MS OPEN TECH); Chris Mills; public-webplatform@w3.org; Doug Schepers (schepers@w3.org); Jacob Rossi
Subject: Re: Recommendation for where to post Pointer Events primer

I would generally be in favor, but on the other hand, there are no non prefixed implementations, not even nightly builds. Even though this is on a standards track, it has not reached an initial milestone with more than one implementation yet. WebKit does not seem to be in favor of this method, for example.
I guess Mozilla is in favor, because one of the editors is one from Mozilla?


☆PhistucK

On Mon, Feb 18, 2013 at 2:32 PM, Arthur Barstow <art.barstow@nokia.com> wrote:
[ + Jacob Rossi ]

Hi All - the Pointer Events v1 spec will be published as Last Call Working Draft on February 19 (<http://www.w3.org/TR/2013/WD-pointerevents-20130219/>).

Given this, it seems like WPD should document the events in the LC spec rather than their ms* equivalents e.g. see <http://docs.webplatform.org/wiki/dom/events>. WDYT?

-Thanks, AB


On 2/17/13 1:26 PM, ext PhistucK wrote:
I would change the link in this paragraph -
"In all of these cases, a pointercancel event is triggered. This gives the developer a chance to handle any clean-up that is needed. More information on pointercancel cases can be found at: http://msdn.microsoft.com/en-us/library/ie/hh846776(v=vs.85).aspx <http://msdn.microsoft.com/en-us/library/ie/hh846776%28v=vs.85%29.aspx>"

To this one -
http://docs.webplatform.org/wiki/dom/events/mspointercancel


It should contain the same information anyway. If this is not sufficient, please, enhance the information of the Web Platform Docs version to match the content to which you really tried to link.
☆*PhistucK*



On Fri, Feb 15, 2013 at 11:22 PM, Rob Dolin (MS OPEN TECH) <robdolin@microsoft.com <mailto:robdolin@microsoft.com>> wrote:

    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 <mailto:cmills@w3.org>]
    Sent: Friday, February 15, 2013 <tel:2013> 2:34 AM
    To: Rob Dolin (MS OPEN TECH)
    Cc: public-webplatform@w3.org <mailto:public-webplatform@w3.org>;
    Doug Schepers (schepers@w3.org <mailto: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 <http://dev.opera.com>

    W3C Fellow, web education and webplatform.org
    <http://webplatform.org> Author of "Practical CSS3: Develop and
    Design" (http://goo.gl/AKf9M)

    On 14 Feb 2013 <tel:2013>, at 23:41, "Rob Dolin (MS OPEN TECH)"

    <robdolin@microsoft.com <mailto: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 Monday, 18 February 2013 16:19:05 UTC