W3C home > Mailing lists > Public > public-webplatform@w3.org > December 2013

Re: Proposed content design for HTML element pages

From: Pat Tressel <ptressel@myuw.net>
Date: Tue, 10 Dec 2013 10:50:53 -0800
Message-ID: <CABT-+2rsRfGrcbqtOEgJWOUwJN33WcwG8cmrJ+tvUyhQEFHT2Q@mail.gmail.com>
To: Jen Simmons <jen@jensimmons.com>
Cc: Alex Komoroske <komoroske@google.com>, Max Polk <maxpolk@gmail.com>, Eliot Graff <Eliot.Graff@microsoft.com>, Julee <julee@adobe.com>, WebPlatform Public List <public-webplatform@w3.org>, Eliezer Bernart <eliezerbernart@gmail.com>, David Singer <singer@apple.com>
> 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.
> Very nice!!  I especially like the before-and-after examples.

Little suggestions:  Since the examples section is long, and the attributes
section (in particular) short, maybe have a TOC or nav bar that points to
the sections, else the others may be overlooked.  The attributes section is
not exhaustive, so perhaps "Common Attributes"?  (I was at the Seattle doc
sprint, where I spent much of the time wringing my hands over just the <a>
tag, and whether it should have only the most common attributes, or a
somewhat more broad set. ;-) )

-- Pat
Received on Wednesday, 11 December 2013 08:33:38 UTC

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