Re: Working on standardizing the doc format for HTML elements

Thanks, Dave! I thought you said you were in the middle of the re-org of the DOM pages. But, are you saying that everything is pretty much in the location they should be?

What is Jen looking at, then?

Thanks.

Julee

-------------------
Julee Burdekin
Content Strategist
Adobe Web Platform
@adobejulee
julee@adobe.com

From: Dave Gash <dave@davegash.com<mailto:dave@davegash.com>>
Reply-To: Dave Gash <dave@davegash.com<mailto:dave@davegash.com>>
Date: Friday, August 15, 2014 at 12:23 PM
To: julee <julee@adobe.com<mailto:julee@adobe.com>>, Pearl Chen <pearlchen@google.com<mailto:pearlchen@google.com>>
Cc: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com<mailto:amelia.bellamy.royds@gmail.com>>, WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>, Eliot Graff <Eliot.Graff@microsoft.com<mailto:Eliot.Graff@microsoft.com>>, Jen Simmons <jen@jensimmons.com<mailto:jen@jensimmons.com>>
Subject: Re: Working on standardizing the doc format for HTML elements

Hi all,
I'm no longer working on DOM pages. In my most recent work for Google, I wasn't moving massive numbers of pages, just those that appeared to be misplaced. And now that I'm at Microsoft, I'm not doing any reorg at all. My understanding is that Jen Simmons is looking at the big picture; she can probably provide more current info than me.

Cheers,
Dave


----- Original Message -----
From:Julee Burdekin<mailto:julee@adobe.com>
To: Pearl Chen<mailto:pearlchen@google.com>
Cc: Amelia Bellamy-Royds<mailto:amelia.bellamy.royds@gmail.com> ; Dave Gash<mailto:dave@davegash.com> ; public-webplatform@w3.org<mailto:public-webplatform@w3.org> ; Eliot Graff<mailto:Eliot.Graff@microsoft.com> ; Jen Simmons<mailto:jen@jensimmons.com>
Sent: Friday, August 15, 2014 12:16 PM
Subject: Re: Working on standardizing the doc format for HTML elements

Yes, there is an HTMLImageElement<[]%20http://docs.webplatform.org/wiki/dom/HTMLImageElement>[1] node, the DOM Image<http://docs.webplatform.org/wiki/dom/Image>,[2] and the element img<http://docs.webplatform.org/wiki/html/elements/img>.[3]

I’m not sure what DOM API Dave is finished with or whether he is doing anything with elements, but he should weigh in here, as he is executing an information architecture we talked about a while back.

HTH

J
[1] http://docs.webplatform.org/wiki/dom/HTMLImageElement

[2] http://docs.webplatform.org/wiki/dom/Image

[3] http://docs.webplatform.org/wiki/html/elements/img

-------------------
Julee Burdekin
Content Strategist
Adobe Web Platform
@adobejulee
julee@adobe.com<mailto:julee@adobe.com>

From: Pearl Chen <pearlchen@google.com<mailto:pearlchen@google.com>>
Date: Friday, August 15, 2014 at 11:44 AM
To: julee <julee@adobe.com<mailto:julee@adobe.com>>
Cc: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com<mailto:amelia.bellamy.royds@gmail.com>>, Dave Gash <dave@davegash.com<mailto:dave@davegash.com>>, WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>, Eliot Graff <Eliot.Graff@microsoft.com<mailto:Eliot.Graff@microsoft.com>>, Jen Simmons <jen@jensimmons.com<mailto:jen@jensimmons.com>>
Subject: Re: Working on standardizing the doc format for HTML elements

By HTML API do you mean how there's <img> and also HTMLImageElement?


On Fri, Aug 15, 2014 at 2:09 PM, Julee Burdekin <julee@adobe.com<mailto:julee@adobe.com>> wrote:
Yay, Pearl!

Besides what Amelia wrote, I just wanted to give you a heads up that Dave Gash was working on restructuring the location of HTML API pages.

If you’re working on the elements, there’s probably no collision there, but I wanted to call this out in case there is anything to share with each other.

J
-------------------
Julee Burdekin
Content Strategist
Adobe Web Platform
@adobejulee
julee@adobe.com<mailto:julee@adobe.com>

From: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com<mailto:amelia.bellamy.royds@gmail.com>>
Date: Friday, August 15, 2014 at 10:59 AM
To: Pearl Chen <pearlchen@google.com<mailto:pearlchen@google.com>>
Cc: WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>, Eliot Graff <Eliot.Graff@microsoft.com<mailto:Eliot.Graff@microsoft.com>>, Jen Simmons <jen@jensimmons.com<mailto:jen@jensimmons.com>>
Subject: Re: Working on standardizing the doc format for HTML elements
Resent-From: WebPlatform Public List <public-webplatform@w3.org<mailto:public-webplatform@w3.org>>
Resent-Date: Friday, August 15, 2014 at 11:00 AM

Hi Pearl,

I also look forward to a more standardized format and clearer style guide.  I was planning on reviewing these templates in prep for cleaning up the SVG pages (which will use the same template for SVG markup elements), so feel free to get in touch with me directly if you want to bounce around any ideas.

Do you think you could create a "Story" in the issue tracker so we can follow along and comment on progress?  Make it a "related issue" to this "Epic" I put together to organize all the template work:
http://project.webplatform.org/content/issues/116


The following bug reports might be also useful in thinking about parts of the current system that other people thought could be improved:
http://project.webplatform.org/infrastructure/issues/61

http://project.webplatform.org/infrastructure/issues/62


Best,
Amelia


On 15 August 2014 10:50, Eliot Graff <Eliot.Graff@microsoft.com<mailto:Eliot.Graff@microsoft.com>> wrote:
Thank you, Pearl.

This is a work item we’ve had on the todo list for some time now. I’m ecstatic that you’re taking this on!

Eliot

From: Pearl Chen [mailto:pearlchen@google.com<mailto:pearlchen@google.com>]
Sent: Friday, August 15, 2014 9:45 AM
To: public-webplatform@w3.org<mailto:public-webplatform@w3.org>; Jen Simmons
Subject: Working on standardizing the doc format for HTML elements

Based on the last month of poking around WPD, I'm noticed a lot of inconsistency with the HTML element docs.

As far as I know, html elements haven't been worked on much yet so I'll take the lead on standardizing how an ideal html element article should be structured.

I'll document this by either editing or augmenting this wiki page: http://docs.webplatform.org/wiki/WPD:Creating_API_pages


Pearl