Re: Agenda items for Friday's general meeting?

I like the immediately visible live examples. And the overall structure
looks good to me, nice job!


☆*PhistucK*


On Fri, Dec 6, 2013 at 6:28 PM, Eliot Graff <Eliot.Graff@microsoft.com>wrote:

> Hi Jen.
>
> Thank you soooooooo much for putting these together. This is a wonderful
> and strong foundation from which we can proceed.
>
> Two general places to start the discussion:
> 1) I've heard a lot of people sing the praises of the way information is
> rendered in HTML: The Markup Language [1] and the W3C Cheat Sheet [2]
> derived from the former. Given that these are terse summaries of the
> attributes, values, etc., I would suggest that we move those items to the
> top of the page, where developers could scan for the information without
> having to scroll past the (hopefully robust) examples on the page.
>
> 2) It's interesting to see the sample code and live sample side by side;
> however, in my experience there's precious little line space available for
> code on a well-designed page. I wonder if cutting that in half would hamper
> how the code is displayed on the page (hard to discern line breaks, etc.)?
> IMHO, having a link to code.webplatform.org open in another instance of
> the browser is ample access to the live sample and allows for a less
> cluttered reference page. Do you feel there's more efficacy in having the
> live sample immediately visible?
>
> I will unfortunately, be in transit through most of this morning's meeting
> but will be on the phone.
>
> Again, thanks so much for pulling these together!!!!!
>
> Eliot
>
> [1] http://dev.w3.org/html5/markup/blockquote.html#blockquote
> [2] http://www.w3.org/2009/cheatsheet/#search,blockquote
>
> From: jensimmons@gmail.com [mailto:jensimmons@gmail.com] On Behalf Of Jen
> Simmons
> Sent: Friday, December 6, 2013 5:45 AM
> To: Alex Komoroske
> Cc: Eliot Graff; Julee; WebPlatform Public List; Max Polk; Eliezer
> Bernart; David Singer
> Subject: Re: Agenda items for Friday's general meeting?
>
> Hello all,
> I'm attaching two pdfs showing a proposed content design for the HTML
> element pages. I've been designing using real content, so do read what's
> there and think about whether/not this structure will work with the range
> of content for HTML.
>
> I wanted to create enough structure to help enforce consistency, but
> enough flexibility to support the diversity of elements. I also wrote this
> content with newbies in mind - students, pro developers who still haven't
> really learned the basics of HTML (sadly, that's a huge number of people),
> etc. Many of the other reference documents I looked at expect a
> intermediate to advanced level of knowledge and mastery. I'm hoping this
> group will agree that our documentation should work for all levels of user
> - from total newbie to ultimate master. This draft is my first attempt to
> find that balance.
>
> We'll talk about this in the meeting today.
>
> Jen
>
>
> Jen Simmons
> designer, consultant and speaker
> host of The Web Ahead
> jensimmons.com
> 5by5.tv/webahead
> twitter: jensimmons
>
>
> On Thu, Dec 5, 2013 at 7:48 PM, Alex Komoroske <komoroske@google.com>
> wrote:
> Unfortunately I won't be able to attend this week's meeting because I'm in
> Sydney this week.
>
> On Fri, Dec 6, 2013 at 11:41 AM, Eliot Graff <Eliot.Graff@microsoft.com>
> wrote:
> Is the a link to the mockup of the html elements page?
>
> Thanks,
>
> Eliot
> ________________________________________
> From: Julee
> Sent: 12/5/2013 3:45 PM
>
> To: WebPlatform Public List
> Cc: jensimmons@gmail.com; Max Polk; Eliezer Bernart; David Singer
> Subject: Agenda items for Friday's general meeting?
> Hi, folks:
>
> Here are some things we could give status about:
>
> * Jen Simmons has a mock up of the HTML elements pages
> * Max Polk has done the 3rd JS import
> * Eliezer Bernart is on templates
> * David Singer has proposed a WebVTT content project
>
> Any other status or topics for tomorrow?
>
> Thanks.
>
> Julee
> ----------------------------
> julee@adobe.com
> @adobejulee
>
>
>
>