This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 17450 - This specification is bloody awful. It looks like it'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
Summary: This specification is bloody awful. It looks like it's been designed for the ...
Status: RESOLVED INVALID
Alias: None
Product: HTML WG
Classification: Unclassified
Component: HTML Microdata (editor: Ian Hickson) (show other bugs)
Version: unspecified
Hardware: Other other
: P3 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL: http://www.whatwg.org/specs/web-apps/...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-06-09 09:30 UTC by contributor
Modified: 2012-06-12 06:12 UTC (History)
4 users (show)

See Also:


Attachments

Description contributor 2012-06-09 09:30:08 UTC
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'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's known as "programmer-wank".

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.  

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

The web badly needs a microdata standard, but this isn't it. You should
probably tear it up and start again. Next time, please try to do it properly,
otherwise we'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
Comment 1 Glenn Adams 2012-06-12 06:12:37 UTC
true, but irrelevant