News for hackers. Stuff that matters.
Re:Just Simply – Stop saying how simple things are in our docs by newswasboring on Sunday April 30, 2023 @11:49AM (#35763697)
Classifying anything which is mental health related as "snowflakes" has lead us to many toxic traits in the current society. I would encourage you to take a harder look at what you are advocating here. To me it looks like to you taking anyone else's feelings into consideration is wasteful. I am sorry, I would rather work with snowflakes than bricks.
Re:Just Simply – Stop saying how simple things are in our docs by shri_krishna on Sunday April 30, 2023 @12:40PM (#35764227)
> Classifying anything which is mental health related as "snowflakes" has lead us to many toxic traits in the current society

So you are implying that the person who wrote this article is suffering from some "mental health issue". I never implied that anywhere in my comment. I called people who require you to adjust to their expectations of what normalcy is, to be snowflake behaviour (which is also the definition of a snowflake btw, if you look up the dictionary). I gave an example of how non-native English speakers already find it hard to write documentation in English in the first place. Now you want people like us to also take into consideration your "feelings" on what words trigger you and what don't before writing a technical documentation? Seriously? What would you do if I wrote the documentation in my native language instead as I am most comfortable in it? I am already going the extra mile in communicating with you in English. Now you want me to stretch that even more to consider your "feelings" too? How about you and I meet in the middle? I'll write documentation in Kannada (which happens to be my native language), and you put the extra effort to read the documentation in my language or get it translated yourself? Would you be comfortable doing that since you "rather work with snowflakes than bricks". Would that work? If not why not? And if you refuse to understand my "feelings" should I call you a "brick"? Everyone faces difficulties learning stuff in their own way. Some are not even proficient in English to even begin to understand the documentation, let alone discern if "simply" or "just" is triggering them or not. Yet most go through with the struggle without creating a fuss or blaming the author of the documentation (who also might be going through their own struggles).

All I am saying is we all have (as a dev community) much harder and pressing problems to solve. Crying over whether to use "simply" or "just" in documentation is not a battle we should be picking. That's my limited point.

Re:Just Simply – Stop saying how simple things are in our docs by Kye on Sunday April 30, 2023 @12:43PM (#35764268)
Apologies if this causes offense, but: you have a single, formidable paragraph with nine questions in it. This is a lot to put on a reader all at once. Consider breaking it up a bit. That many questions all at once can feel more like an interrogation, while good communication feels like a conversation.
Re:Just Simply – Stop saying how simple things are in our docs by shri_krishna on Sunday April 30, 2023 @12:51PM (#35764353)
No offense taken. Appreciate your input.