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

Re: Working on standardizing the doc format for HTML elements

From: Julee Burdekin <julee@adobe.com>
Date: Fri, 15 Aug 2014 18:09:51 +0000
To: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com>, Pearl Chen <pearlchen@google.com>, Dave Gash <dave@davegash.com>
CC: "public-webplatform@w3.org" <public-webplatform@w3.org>, Eliot Graff <Eliot.Graff@microsoft.com>, Jen Simmons <jen@jensimmons.com>
Message-ID: <D01399E9.E2BC5%julee@adobe.com>
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.

Julee Burdekin
Content Strategist
Adobe Web Platform

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:

The following bug reports might be also useful in thinking about parts of the current system that other people thought could be improved:



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!


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


Received on Friday, 15 August 2014 18:10:22 UTC

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