Re: Working on standardizing the doc format for HTML elements

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

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