Vuejs.org: International Humor Committee for Pun Approval and Joke Acceptance
I guess there should be more jokes in the guide. It's not hard to read as it is, but having a little fun never hurts.
gbezyuk
All 11 comments
Ha, it's not every day that someone asks for _more_ of my jokes, so thank you! 馃槀 I'm an educator and in my curricula focused on Americans, I do try to include a lot of humor and I've received feedback from students that it's very much appreciated by most.
When writing the Vue docs however, I've tried to hold myself back more. The reason is Vue's community is much more international and I've learned from past experience that humor can be difficult to translate. Sarcasm can be offputting or easy-to-miss, puns usually require a stronger grasp of the language, and general silliness can come across as strange, childish, or even insulting to some.
That said, I'd be open to PRs to include more jokes (one joke at a time please). 馃檪 Our community and core team are spread throughout the world, so we can reference new jokes in this issue and review them one at a time for their international appeal/acceptance.
chrisvfritz
on 26 Oct 2016
Sounds great. I believe, according to the online/hypertext nature of this documentation one of the best ways for jokes here could be trough citations of well-known comic figures. For one, nobody expects the Spanish Inquisition. Especially in list rendering examples.
gbezyuk
on 26 Oct 2016
In the "Vue vs. Angular 2: Learning Curve" section of comparison.md there's a place looking suitable for some good old British Humour. I suggest replacing this sentence:
It's an understatement to say that [Vue's Hello World](index.html#Hello-World) is considerably simpler. It's so trivial in fact, that we don't even dedicate a whole page in the guide to it.
with something more humble, like:
It wouldn't be an exaggeration to say that [Vue's Hello World](index.html#Hello-World) is a little bit simpler. Maybe because of that, we don't even need to dedicate a whole page in the guide to it.
gbezyuk
on 6 Nov 2016
@gbezyuk I'm open to that PR. 馃檪
chrisvfritz
on 7 Nov 2016
@chrisvfritz see #573
gbezyuk
on 7 Nov 2016
A bit on the Spanish Inquisition mentioned above, or how to stay true to Python even while using JavaScript.
https://github.com/gbezyuk/minimalistic-yet-fully-featured-vuex-example/blob/standalone-vue/img/step1.png
gbezyuk
on 8 Nov 2016
@gbezyuk Ha, nice. I'd like to avoid pop culture references though - even ones that are well-known in many parts of the world.
chrisvfritz
on 8 Nov 2016
For a Russian translation only, in the description of v-show, I propose to use a reference to a famous post-soviet movie quote. As v-show does not really remove nodes from DOM tree, the well-known idiom "can you see the gopher? anyway, there is one..." feels to fit:
v-show
...
<div v-show="Math.random() > 0.5">
袙懈写懈褕褜 褋褍褋谢懈泻邪? 袗 芯薪 械褋褌褜...
</div>
(see https://www.youtube.com/watch?v=EHX7NZS8zAI for the original movie scene)
gbezyuk
on 10 Nov 2016
@gbezyuk Sounds good to me! I think pop-culture references are OK in less global languages, as long as you believe ~90% of readers will understand the reference and it won't be more confusing for the other 10%. I'll leave that judgment to you. 馃檪
chrisvfritz
on 10 Nov 2016
The reason is Vue's community is much more international and I've learned from past experience that humor can be difficult to translate. Sarcasm can be offputting or easy-to-miss, puns usually require a stronger grasp of the language, and general silliness can come across as strange, childish, or even insulting to some.
Yes! Thank you for that!
I'm not against fun, silly pun and all the jazz. But your jokes could also be dated, cringy, dad level bad, and/or just plain uncool. You think you meme are fresh but the guide will stay the same for years.
Please keep the guide a tool to learn about vuejs without any distraction. Yeah, I'm fun at parties...
I personally like to find little nuggets of humor here and there, but I know people who will not take these in a good way. It could give a bad (not "serious business") image to these people and Vuejs is still relatively small and don't need that.
You can have all the fun in the world in the chat/forum/subreddit/whatever.
To sum up:
- bad point
- hard to translate
- could be misinterpreted (seem strange, childish, unprofessional, insulting, dated)
- could be misunderstood
- create a distraction from the content of the guide
- could be polarizing for the community
- good point
- make some dev giggle or more (we need that sometime)
- give a personality to the guide and therefore Vuejs as a whole
- motivate people to read the guide
That was just my humble opinion. Sorry for being a party pooper...
lionel-bijaoui
on 16 Feb 2017
I guess we can close this issue now and address its spirit in a case by case basis.
phanan
on 29 Jan 2019
Related issues
yyx990803
路
4Comments
jgtorrejon
路
5Comments
bencooper222
路
3Comments
sherzinger
路
3Comments
estyh
路
5Comments
Most helpful comment
Ha, it's not every day that someone asks for _more_ of my jokes, so thank you! 馃槀 I'm an educator and in my curricula focused on Americans, I do try to include a lot of humor and I've received feedback from students that it's very much appreciated by most.
When writing the Vue docs however, I've tried to hold myself back more. The reason is Vue's community is much more international and I've learned from past experience that humor can be difficult to translate. Sarcasm can be offputting or easy-to-miss, puns usually require a stronger grasp of the language, and general silliness can come across as strange, childish, or even insulting to some.
That said, I'd be open to PRs to include more jokes (one joke at a time please). 馃檪 Our community and core team are spread throughout the world, so we can reference new jokes in this issue and review them one at a time for their international appeal/acceptance.