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

Re: DOM reorg project next steps

From: Jonathan Garbee <jonathan@untamedworlds.com>
Date: Wed, 29 Jan 2014 07:40:23 -0500
Message-ID: <CANCFA+GAcTYg1wPCousLGv=YHowapKiFuMGu5Tp8zhT9CgNRsA@mail.gmail.com>
To: public-webplatform@w3.org
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
>>>
>>>
>>>
>>> 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 Wednesday, 29 January 2014 14:04:45 UTC

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