LOL! The lecture is as much aimed at the jQuery documentors as at you. The few times I've had to dip into jQuery docs to find something I, too, have been frustrated.
I mean look at this page:
First of all, you have to realize that you need to click on the second definition of the method, getting you to here:
And then, finally, you can find the paragraph that says:
We need to be aware that this method escapes the string provided as necessary so that it will render correctly in HTML. To do so, it calls the DOM method .createTextNode(), does not interpret the string as HTML.
So the docs indeed say it, but not right up front in clear English.
To be fair to you, I've had over 40 years experience both reading and writing documentation, so I've learned *how* to look for the gotchas like this. Truly, reading and understanding documentation is as much an art form as anything.
Anyway, it took me a while to find the problem, since I don't use jQuery, hence my comment about "yucky old jQuery." Definitely not really aimed at you.