FAQ: Worth adding "avoid createElement()/createAttribute()"?

I am still seeing people confused by the fact that createElement("foo") 
and createElementNS(null,"foo") are not interchangable. Ditto for 
attributes.

I can point them to DOM 2.0 Core 1.1.8, but it would be good to have an 
official practical-advice summary. "Yes, they're different and not really 
ineroperable. Unless you are writing a pure DOM 1.0 application, don't use 
the non-namespace-aware version of these calls." 

Or something along those lines, easy to find and short enough to absorb at 
a glance.

(A few folks have also grumbled "why isn't that advice in the Javadoc?". 
Might be worth considering for future releases.)

______________________________________
Joe Kesselman  / IBM Research