Jokes in the documentation

I’m writing the website’s documentation right now, and I like to sneak in some jokes. Do you think this will offend some customers? Don’t get me wrong, it’s very useful, but it also has jokes, I guess I like to kid around . Did anyone else do this, and if yes, did you receive negative feedback?

I am sure some of them who really read it will appreciate the jokes.

Depends on the type of humor. Emotions are 90% of marketing (and user science at all), so in the general case – yes, it’s helpful.

I would have nothing against jokes in the documentation. But that’s just me

It depends on how closer you (and the product) are to the buyer. Someone who could’t find their solutions on documentation may feel heat with jokes (even if it is technically super blended). As a buyer, while going through other’s documentation for quick help, many times came across the impressions like “All these excitments can be better spent on simplifying the help/documentation”.

Thanks for the answers, I guess the jokes are here to stay . BTW , any tips for writing the documentation as complete and helpful as possible? It can get quite overwhelming.

Well as we all know, nobody reads the support docs anyway

Although jokes may cause a customer to feel at ease with the purchase, and the author from whom they purchased it from, it’s still extremely unprofessional…

If you purchased a box of dry ice, would you want the support documentation stating : “Do not touch with bare hands! Well, unless you want your hands to freeze off.”

Just wouldn’t make any sense, so why should a joke within a template help doc?

designcrumbs said
Well as we all know, nobody reads the support docs anyway

haha