The biggest problem I've found with the docs for XML::LibXML is that I have to keep in mind the @ISA hierarchy, and remember that a Document @ISA Node, for example. But I've never actually found the docs lacking any essential information that I couldn't quickly test to confirm.

IMHO, that's a problem with the DOM specification, not LibXML itself. Too much junk in there trying to be language-agnostic. And yet you still can't get a BF implementation . . .