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 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 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]