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:14:39 -0800
Message-ID: <CAOm3JBeJPs1mQBEtLteS6bUTV6hFmVvXP07m1LXf=thhfbHBXQ@mail.gmail.com>
To: Julee <julee@adobe.com>
Cc: PhistucK <phistuck@gmail.com>, Jonathan Garbee <jonathan@garbee.me>, "public-webplatform@w3.org" <public-webplatform@w3.org>, Scott Rowe <scottrowe@google.com>
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:15:07 UTC

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