search

benschwarz / developers.whatwg.org

Used to create the contents of developers.whatwg.org
http://developers.whatwg.org/
198 stars 39 forks source link

IDL attribute definition #68

Closed sinthiav closed 8 years ago

sinthiav commented 12 years ago

As a first-time reader of this document, I found the frequent references to IDL attributes and content attributes very confusing. I had never heard of IDL attributes before. I would suggest a clear definition of these terms and their differences with a link to http://dev.w3.org/2006/webapi/WebIDL would make this document much more readable and understandable. While http://developers.whatwg.org/introduction.html#audience states that familiarity with IDL is optional, I found it impossible to understand this document without at least a definition of IDL. I thought until today that IDL referred to Microsoft's COM-RPC bindings, so you can see why it confused me.

benschwarz commented 8 years ago

Covered by the source material, not this repo.