TheOdinProject / curriculum

The open curriculum for learning web development
https://www.theodinproject.com/
Other
9.78k stars 13.14k forks source link

FS RoR: Conditional Logic: Possibly inappropriate metaphor #28779

Closed ruben-vl closed 2 days ago

ruben-vl commented 1 week ago

Checks

Describe your suggestion

In the paragraph on truty and falsy values in Ruby, the metaphor of bugs in a decomposing body is used.

While this analogy can be funny (?), it's not really a visual I want to get in my head when learning to code (or really in any circumstance actually).

I get that it's just a metaphor, but not everyone will take this as funny or light-hearted, so it seems unnecessary in my opinion.

Path

Ruby / Rails

Lesson Url

https://www.theodinproject.com/lessons/ruby-conditional-logic

(Optional) Discord Name

ruben-vl

(Optional) Additional Comments

No response

sukairaida commented 1 week ago

Is funny how yesterday I read that too and thought the same. It is not a nice thing to imagine and it took me offguard. I really do believe that the Ruby lessons could be rewritten or at least modified to be more professional and clear, rather than having unnecessary metaphors, jokes and analogies.

I like this paragraph from Bjarne Stroustrup's "Programming principles and practice using C++", and in this context, even more the last sentence:

We try to respect your intelligence and to be considerate about your time. In our presentation, we aim for professionalism rather than cuteness, and we’d rather understate a point than hype it. We try not to exaggerate the importance of a programming technique or a language feature, but please don’t underestimate a simple statement like “This is often useful.” If we quietly emphasize that something is important, we mean that you’ll sooner or later waste days if you don’t master it. Our use of humor is more limited than we would have preferred, but experience shows that people’s ideas of what is funny differ dramatically and that a failed attempt at humor can be confusing.

JoshDevHub commented 5 days ago

Thank you for making this issue @ruben-vl . I'm fine with this joke being removed. Since you indicated you don't want to work on it, I'll open it up for someone else to work on.

Comment below to be assigned.

XAJX179 commented 5 days ago

can i be assigned?

JoshDevHub commented 5 days ago

@XAJX179 Thank you for volunteering! I'll assign you.

ruben-vl commented 4 days ago

Very nice fix @XAJX179, couldn’t have come up with a better one!

XAJX179 commented 4 days ago

Very nice fix @XAJX179, couldn’t have come up with a better one!

Thank you! ♥