Github user ChristopherSchultz commented on the issue:
https://github.com/apache/tomcat/pull/79
A few years ago, Rich Bowen gave a talk @ ApacheCon about documentation and
communities. He used Python as an example of a community where the Monty Python
jokes are so pervasive, it appears that they have become the focus of the
documentation instead of the actual subject (the code, etc.).
He suggested that humor, while intended to be fun, lighthearted, etc. often
comes across as mean-spirited or condescending, and/or introduces confusion
especially to those who do not understand (a) the language (e.g. English), (b)
that they are in fact jokes or (c) the content of the jokes (e.g. unfamiliar
with Monty Python).
Basically, this kind of thing doesn't have a place in high-quality
documentation.
This example is relatively benign, but there are probably other places
where the humor is at least distracting if not worse.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
