Re: DOM reorg project next steps

A listing of all of the events might be helpful, but it does not mandate
putting all of them under the same path.
You can query for a type-event (of some sort) property and create a listing
this way, I imagine. It might include all of the events in the entire wiki
if you go in this route, which is probably good.


☆*PhistucK*


On Wed, Jan 29, 2014 at 2:40 PM, Jonathan Garbee <jonathan@untamedworlds.com
> wrote:

> I don't get why we should set the interface in the URL at all. These are
> all just "events". It would make much more sense if a developer is looking
> for an event that they should go to dom/events and then have a listing
> (possibly with a filter/categorized by the interface) of all the events
> available. Then for editors we have a dropdown in the "overview
> information" which selects the interface that is in use.
>
>
> On Tue, Jan 28, 2014 at 3:30 PM, David Gash <dgash@google.com> wrote:
>
>> 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<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
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
>