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

Re: Working on standardizing the doc format for HTML elements

From: Dave Gash <dave@davegash.com>
Date: Fri, 15 Aug 2014 12:51:36 -0700
Message-ID: <2A89F8CF3E734783B7843F13A76A201A@dell257ee54463>
To: "Julee Burdekin" <julee@adobe.com>, "Pearl Chen" <pearlchen@google.com>
Cc: "Amelia Bellamy-Royds" <amelia.bellamy.royds@gmail.com>, <public-webplatform@w3.org>, "Eliot Graff" <Eliot.Graff@microsoft.com>, "Jen Simmons" <jen@jensimmons.com>
Hi Julee,
Yes, while at Google I undertook a fairly large project (under Scott Rowe, then Peter Lubbers and Scott Main) to remove interstitials like dom/properties, dom/methods, and dom/events, and in that project I moved many pages under their proper objects. For example, dom/properties/head became dom/Document/head, and so on. That project was limited to the dom/ leg, and was completed, so most pages under dom/ should be in their appropriate places now.

Before moving over to MS, I was most recently doing an edit/update pass, working from this search page, but in this pass I was not moving pages.

I don't know what Jen is doing at the moment; she'll have to fill you in on that.

Cheers,
d.


  ----- Original Message ----- 
  From: Julee Burdekin 
  To: Dave Gash ; Pearl Chen 
  Cc: Amelia Bellamy-Royds ; public-webplatform@w3.org ; Eliot Graff ; Jen Simmons 
  Sent: Friday, August 15, 2014 12:30 PM
  Subject: 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>
  Reply-To: Dave Gash <dave@davegash.com>
  Date: Friday, August 15, 2014 at 12:23 PM
  To: julee <julee@adobe.com>, Pearl Chen <pearlchen@google.com>
  Cc: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.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



  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
Received on Friday, 15 August 2014 19:52:09 UTC

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