A well-constructed joke can make documentation more useful. I can't think of an example off the top of my head, but there've been plenty of times that something

A well-constructed joke can make documentation more useful. I can't think of an example off the top of my head, but there've been plenty of times that something made me laugh and go "NOW I get it!" to the technical material. This isn't a well-constructed joke in that sense - it's likely to cause confusion, not increased understanding.