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 
  To: Pearl Chen 
  Cc: Amelia Bellamy-Royds ; Dave Gash ; public-webplatform@w3.org ; Eliot Graff ; Jen Simmons 
  Sent: Friday, August 15, 2014 12:16 PM
  Subject: Re: Working on standardizing the doc format for HTML elements


  Yes, there is an HTMLImageElement[1] node, the DOM Image,[2] and the element 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


  From: Pearl Chen <pearlchen@google.com>
  Date: Friday, August 15, 2014 at 11:44 AM
  To: julee <julee@adobe.com>
  Cc: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com>, Dave Gash <dave@davegash.com>, WebPlatform Public List <public-webplatform@w3.org>, Eliot Graff <Eliot.Graff@microsoft.com>, Jen Simmons <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> 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


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