W3C home > Mailing lists > Public > public-webplatform@w3.org > January 2014

Re: DOM reorg project next steps

From: David Gash <dgash@google.com>
Date: Tue, 28 Jan 2014 12:30:36 -0800
Message-ID: <CAOm3JBc=bdnyKRpkdvGA_aMuikWNtW-Yb5sdxkeaZYG8n5VeJg@mail.gmail.com>
To: PhistucK <phistuck@gmail.com>
Cc: Julee <julee@adobe.com>, Jonathan Garbee <jonathan@garbee.me>, "public-webplatform@w3.org" <public-webplatform@w3.org>, Scott Rowe <scottrowe@google.com>
I see your point, but have to refer you to Scott; it's his proposal.



On Tue, Jan 28, 2014 at 12:21 PM, PhistucK <phistuck@gmail.com> wrote:

> This specifically looks weird to me. keypress is not an event of
> KeyboardEvent. I mean, structurally, it is not KeyboardEvent.keypress or
> KeyboardEvent.onkeypress.
> It should be under GlobalEventHandlers (or under whatever common interface
> it is specified).
> The hierarchy you (or Scott) have chosen really does not make sense to me.
>
>
> ☆*PhistucK*
>
>
> On Tue, Jan 28, 2014 at 10:14 PM, David Gash <dgash@google.com> wrote:
>
>> Hi Julee,
>>
>> Thanks for putting me in the loop; copying Scott on this reply.
>>
>> Julee is correct. I've been working for some time to eliminate
>> unnecessary interstitials per Scott's reorg proposal[1], so the listing
>> pages dom/objects, dom/events, dom/properties, and dom/methods are now
>> gone, as are all their sub-pages, in favor of placing those sub-pages under
>> their proper parents. I've moved hundreds of pages about in this effort.
>>
>> So yes, keypress should be at dom/KeyboardEvent/keypress, not
>> dom/events/keypress.
>>
>> Dave
>>
>>
>> [1] http://docs.webplatform.org/wiki/WPD:Projects/DOM_API_docs
>>
>>
>>
>> On Tue, Jan 28, 2014 at 11:33 AM, Julee <julee@adobe.com> wrote:
>>
>>> Hi, Garbee:
>>>
>>> Before we move pages, Dave Gash should probably weigh in. He has been
>>> working on the reorg for months now, based on Scott’s initial architecture.
>>>
>>> Dave: Correct me if I’m wrong, but…
>>>
>>> If there’s some questions, Dave should be in on the discussions.
>>>
>>> J
>>>
>>> -------------------
>>> Julee Burdekin
>>> Content Strategist
>>> Adobe Web Platform
>>> @adobejulee
>>> julee@adobe.com
>>>
>>> From: PhistucK <phistuck@gmail.com>
>>> Date: Sunday, January 26, 2014 at 12:51 PM
>>> To: Jonathan Garbee <jonathan@garbee.me>
>>> Cc: WebPlatform Public List <public-webplatform@w3.org>
>>> Subject: Re: DOM reorg project next steps
>>>
>>> I guess common events can be under events (but should, for correctness,
>>> be under GlobalEventHandlers<http://www.whatwg.org/specs/web-apps/current-work/multipage/webappapis.html#globaleventhandlers>.
>>> At least those that are specified to be there).
>>> If I recall correctly, we chose this route (putting events under their
>>> interface) for the APIs hierarchy and I think it makes sense.
>>> Only some events are general, a lot of them belong under specific
>>> interfaces.
>>>
>>>
>>> ☆*PhistucK*
>>>
>>>
>>> On Sun, Jan 26, 2014 at 10:05 PM, Jonathan Garbee <jonathan@garbee.me>wrote:
>>>
>>>> Ok, I just checked the history of the keypress page and saw it was
>>>> moved to KeyboardEvents/keypress as the new organization dictates. So I've
>>>> moved it back.
>>>>
>>>> However, why are we setting URLs based on the interface in play?
>>>> Couldn't we simply set the interface as an option in the form compared to
>>>> using the URL? I think it would make more sense to have all events under
>>>> dom/events to make it easier for developers to find all the events that
>>>> exist.
>>>>
>>>>
>>>> On Sun, Jan 26, 2014 at 2:00 PM, Jonathan Garbee <jonathan@garbee.me>wrote:
>>>>
>>>>> I'm a bit confused on how we are to structure events. Take keypress[1]
>>>>> for example. Should I have left it at dom/keyboardEvents/keypress or did I
>>>>> do the right thing in moving it to dom/events/keypress? I'd like to know
>>>>> before I move further pages as I work on them.
>>>>>
>>>>> Thanks,
>>>>> -Garbee
>>>>>
>>>>> [1] http://docs.webplatform.org/wiki/dom/events/keypress
>>>>>
>>>>>
>>>>> On Wed, Dec 4, 2013 at 4:14 PM, PhistucK <phistuck@gmail.com> wrote:
>>>>>
>>>>>> By the way, ​​I compiled a list back then with articles that should
>>>>>> be moved, or various other issues, it might be helpful in your journey as
>>>>>> well -
>>>>>> http://docs.webplatform.org/wiki/WPD:Content_Tasks
>>>>>>
>>>>>>
>>>>>> ☆*PhistucK*
>>>>>>
>>>>>>
>>>>>> On Wed, Dec 4, 2013 at 11:09 PM, Doug Schepers <schepers@w3.org>wrote:
>>>>>>
>>>>>>> Hi, Dave–
>>>>>>>
>>>>>>> I think you're safe to go ahead, thanks! At some point, we should
>>>>>>> address PhistucK's suggestion about the "applies_to" field, but I think
>>>>>>> that's somewhat orthogonal for now.
>>>>>>>
>>>>>>> Regards-
>>>>>>> -Doug
>>>>>>>
>>>>>>>
>>>>>>> On 12/4/13 3:47 PM, Julee Burdekin wrote:
>>>>>>>
>>>>>>>> Yes, thanks, Dave! Looks like you’re the only one who has been
>>>>>>>> working in wiki/dom:
>>>>>>>>
>>>>>>>> http://docs.webplatform.org/w/index.php?title=Special:
>>>>>>>> RecentChanges&days=30&from=&namespace=0
>>>>>>>>
>>>>>>>>  Regards!
>>>>>>>>
>>>>>>>> Julee ---------------------------- julee@adobe.com @adobejulee
>>>>>>>>
>>>>>>>> From: Eliot Graff <Eliot.Graff@microsoft.com
>>>>>>>> <mailto:Eliot.Graff@microsoft.com>> Date: Wednesday, December 4,
>>>>>>>> 2013
>>>>>>>>
>>>>>>>> at 12:38 PM To: David Gash <dgash@google.com
>>>>>>>> <mailto:dgash@google.com>>, WebPlatform Public List
>>>>>>>> <public-webplatform@w3.org <mailto:public-webplatform@w3.org>> Cc:
>>>>>>>> Peter Lubbers <peterlubbers@google.com
>>>>>>>> <mailto:peterlubbers@google.com>>, Scott Rowe <scottrowe@google.com
>>>>>>>> <mailto:scottrowe@google.com>> Subject: RE: DOM reorg project next
>>>>>>>>
>>>>>>>> steps Resent-From: WebPlatform Public List <
>>>>>>>> public-webplatform@w3.org
>>>>>>>>  <mailto:public-webplatform@w3.org>> Resent-Date: Wednesday,
>>>>>>>> December
>>>>>>>>
>>>>>>>> 4, 2013 at 12:39 PM
>>>>>>>>
>>>>>>>> Thanks for the notice, Dave! Appreciate the work.
>>>>>>>>
>>>>>>>> Eliot
>>>>>>>>
>>>>>>>> *From:*David Gash [mailto:dgash@google.com] *Sent:* Wednesday,
>>>>>>>> December 4, 2013 12:37 PM *To:* public-webplatform@w3.org
>>>>>>>> <mailto:public-webplatform@w3.org> *Cc:* Peter Lubbers; Scott Rowe
>>>>>>>> *Subject:* DOM reorg project next steps
>>>>>>>>
>>>>>>>>
>>>>>>>> Hi all,
>>>>>>>>
>>>>>>>> As you may know, one of the big projects on my Google contract is
>>>>>>>> reorganizing the pages under docs.webplatform.org/wiki/dom
>>>>>>>> <http://docs.webplatform.org/wiki/dom>, as outlined in Scott Rowe's
>>>>>>>> project document
>>>>>>>> <http://docs.webplatform.org/wiki/WPD:Projects/DOM_API_docs>. Most
>>>>>>>> of
>>>>>>>>
>>>>>>>>  these pages were imported and many ended up miscategorized or
>>>>>>>> placed
>>>>>>>>  under unneccessary interstitials, so I'm moving them about and
>>>>>>>> correcting the "applies_to" fields in a concentrated effort to end
>>>>>>>> up
>>>>>>>>  with a more straightforward, logical URL structure.
>>>>>>>>
>>>>>>>> I am /not/ editing page content during this project, the goal being
>>>>>>>>
>>>>>>>> to first get the pages where they belong, so that they can easily be
>>>>>>>> found for later updating.
>>>>>>>>
>>>>>>>> I've been working on this project for several weeks, and have
>>>>>>>> completed the dom/apis/audio-video, dom/events, and dom/objects
>>>>>>>> branches; this leaves dom/apis, dom/properties, and dom/methods.
>>>>>>>> There are just over 600 pages in that set, each of which must be
>>>>>>>> examined and either edited & moved or deleted. That's my next group
>>>>>>>> to work on.
>>>>>>>>
>>>>>>>> Peter Lubbers has asked me to post this to the list before I begin
>>>>>>>> this group, to make sure that no one else is working on those pages
>>>>>>>> and that no one has objections to the plan. If yes to either, please
>>>>>>>> let us know.
>>>>>>>>
>>>>>>>> Thanks,
>>>>>>>>
>>>>>>>> Dave Gash
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
>
Received on Tuesday, 28 January 2014 20:31:04 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:57 UTC