Dealing misleading documentation

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
Report Content as Inappropriate

Dealing misleading documentation

Henri Sivonen
I has been brought to my attention that https://developer.mozilla.org/en/Using_XML_Data_Islands_in_Mozilla looks like a Mozilla endorsement of putting random stuff between <xml> and </xml> tags in text/html content.

Neither the new HTML parser nor the old HTML parser has any explicit support for <xml>...</xml>. It's just invalid and unknown markup.

It would be more appropriate for developer.mozilla.org to present how to put XML content into an HTML5 "data block" (i.e. <script type="application/xml">...</script>) and parse it using DOMParser. This approach would work properly in Firefox, WebKit, Opera and IE9.

Do we have some kind of standard operating procedure for dealing with misleading docs? I'm a bit shy to just delete or overwrite the old doc on my own initiative.

Henri Sivonen
[hidden email]
dev-documentation mailing list
[hidden email]