[GitHub] tomcat issue #79: remove placeholders from introduction doc

2017-10-31 Thread ChristopherSchultz
Github user ChristopherSchultz commented on the issue: https://github.com/apache/tomcat/pull/79 References: https://apacheconna2015.sched.com/event/2P6d/rtfm-write-a-better-fm-rich-bowen-apache-software-foundation

[GitHub] tomcat issue #79: remove placeholders from introduction doc

2017-10-31 Thread ChristopherSchultz
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

[GitHub] tomcat issue #79: remove placeholders from introduction doc

2017-10-19 Thread pmcelhaney
Github user pmcelhaney commented on the issue: https://github.com/apache/tomcat/pull/79 IMHO the humor doesn’t work here. It comes across as condescending. It’s *definitely* not helpful. --- - To unsubscribe,

[GitHub] tomcat issue #79: remove placeholders from introduction doc

2017-10-19 Thread markt-asf
Github user markt-asf commented on the issue: https://github.com/apache/tomcat/pull/79 We could pull the entries and add "That's it!" after the list. --- - To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org

[GitHub] tomcat issue #79: remove placeholders from introduction doc

2017-10-19 Thread csutherl
Github user csutherl commented on the issue: https://github.com/apache/tomcat/pull/79 This is a least the fourth time I've seen someone asking about this. Should we make a note or use a sarcasm font or something? :) It's funny, but seems to be confusing new folks. ---

[GitHub] tomcat issue #79: remove placeholders from introduction doc

2017-10-19 Thread markt-asf
Github user markt-asf commented on the issue: https://github.com/apache/tomcat/pull/79 Those aren't placeholders. It is intentional content. I believe they are meant to be a lighthearted way of indicating that 'Context' is the only term that needs introducing. ---