<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>17450</bug_id>
          
          <creation_ts>2012-06-09 09:30:08 +0000</creation_ts>
          <short_desc>This specification is bloody awful. It looks like it&apos;s been designed for the subset of computer programmers that get off on the sort of jargon-ridden computer documentation that only other hardcore computer programmers can read.  In more everyday language</short_desc>
          <delta_ts>2012-06-12 06:12:37 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>HTML Microdata (editor: Ian Hickson)</component>
          <version>unspecified</version>
          <rep_platform>Other</rep_platform>
          <op_sys>other</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>INVALID</resolution>
          
          
          <bug_file_loc>http://www.whatwg.org/specs/web-apps/current-work/#top</bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P3</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>contributor</reporter>
          <assigned_to name="Ian &apos;Hixie&apos; Hickson">ian</assigned_to>
          <cc>glenn</cc>
    
    <cc>mike</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>68894</commentid>
    <comment_count>0</comment_count>
    <who name="">contributor</who>
    <bug_when>2012-06-09 09:30:08 +0000</bug_when>
    <thetext>Specification: http://dev.w3.org/html5/md/
Multipage: http://www.whatwg.org/C#top
Complete: http://www.whatwg.org/c#top

Comment:
This specification is bloody awful.

It looks like it&apos;s been designed for the subset of computer programmers that
get off on the sort of jargon-ridden computer documentation that only other
hardcore computer programmers can read. 

In more everyday language, this is what&apos;s known as &quot;programmer-wank&quot;.

Writing webpages is no longer an activity confined to the ranks of people with
degrees in cybernetics. Little old ladies now write webpages to advertise
their church fairs. If you want those people to write webpages that are more
search-engine friendly, and that use more metadata, then you have to make an 
effort to make both the code and the documentation more readable and more
accessible to a wider public. So far, this microdata effort fails miserably in
that respect.  

&quot;This section is non-normative&quot;. ??? 
If people can&apos;t write clear English, using a reasonable vocabulary, then they
probably shouldn&apos;t be writing webpages for the public. And if they don&apos;t
understand how to use language in a way that most people can understand, then
they probably shouldn&apos;t be defining specifications and standards for how
information is communicated.

The web badly needs a microdata standard, but this isn&apos;t it. You should
probably tear it up and start again. Next time, please try to do it properly,
otherwise we&apos;ll just have to abandon the W3C and hand the job over to an
outside party.

Posted from: 188.29.112.212
User agent: Mozilla/5.0 (Windows NT 5.1; rv:12.0) Gecko/20100101 Firefox/12.0</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>68943</commentid>
    <comment_count>1</comment_count>
    <who name="Glenn Adams">glenn</who>
    <bug_when>2012-06-12 06:12:37 +0000</bug_when>
    <thetext>true, but irrelevant</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>