Re: DOM reorg project next steps

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=3
>>>>> 0&from=&namespace=0
>>>>> <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 <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
>>>>> <mailto:public-webplatform@w3.org> >> Cc:
>>>>> Peter Lubbers <peterlubbers@google.com
>>>>> <mailto: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 <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 <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>
>>>>> <http://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
>>>>> <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
>>>>> 
>>>> 
>>>> 
>>>> 
>>> 
>> 
>