Proposal for developing HTML 5 materials for Web *authors*

ACTION-5 Make a proposal on the mailing list for the creation of a  
task force for developer community outreach  [3]


During the last F2F at the Technical Plenary in Cambridge, we had a  
lively discussion on [HTML 5 for authors][2] and more precisely the  
lack of materials for people developing and designing Web sites. The  
traditional readers of HTML Specifications were by large the Web  
development community. The [HTML 5 Editor draft][1] has been written  
with the implementers in mind. Then the usual community is at lost  
reading the document.

There is a need for reference materials for helping authors to develop  
and write HTML 5.

HTML 5 author materials can only be a subset of what is defined in  
HTML 5 document. This document will not promote techniques or syntaxes  
which are illegal in HTML 5. Web designers, webmasters, Web  
developers, teachers collectively may decide that a stricter subset of  
HTML 5 is useful in their practices of the Web.

People have during the F2F expressed a will to participate to such  
materials. There is a few possibilities:

* W3C Working Group Note
* Dedicated wiki with pages having some locked sections (peer process  
review) and free editing sections for example, etc.

Some issues arose during the F2F and corridors discussions.

* Shall the syntax style be stricter than the one recommended by HTML  
5 specification.
   <p class=intro>Readable Markup
   <p class="intro">Readable Markup</p>

* Banning the use of some elements and/or proposing better techniques.
   <font size=+2>

* What about authoring tools and validators?

* How this material will be marketed to the community?

* What to do if people try to enforce them on others?

I put Roger Johansson in Cc: because a few months ago, we started a  
document on what could be an HTML 5 for authors. It was very  
preliminary work and with nothing much into it. We wanted this  
document to be written by the community itself and we define a  
template of things which could fit in such document.

     [NAME] element

     A short description of what is the element and the
     requirements defined in the specification.

     Best Practices
     Think about the best way to use this element, not only for
     its semantics content, but also for the current practical
     benefits, it creates. For example, using the blockquote
     element to create a quote and how to reuse it an engine
     extracting quote from the Web or a personal Web site. If you
     have script share them. When the list of Best Practices is
     too long, please create a separate document with detailed
     explanation. @@contribution license here@@

     If there are specific requirements or techniques for
     accessibility, share in this section.

     If there are specific requirements or techniques for
     internationalization, share in this section.

     Some practical simple examples that you are using in a
     professional context to illustrate the element


Karl Dubost - W3C
Be Strict To Be Cool

Received on Wednesday, 21 November 2007 06:21:23 UTC