News for hackers. Stuff that matters.
Re:If someone’s having to read your docs, it’s not “simple” by thiht on Monday June 07, 2021 @03:27AM (#27419980)
Simple is the opposite of complex, not the opposite of hard. Saying something is simple has meaning, and it's not insulting.
Re:If someone’s having to read your docs, it’s not “simple” by Dashron on Monday June 07, 2021 @06:47AM (#27421054)
It's not a good feeling when you find something "simple" to be hard. Few tasks are easy when you're a new programmer still wrapping your head around conditionals.

If my docs might be used by a new programmer I try to avoid alienating my users with the word simple.

Re:If someone’s having to read your docs, it’s not “simple” by Kronen on Monday June 07, 2021 @01:23PM (#27425277)
The real question and a better post than the original post would be: Are people living in the 21st Century too easily offended?

But it's a rhetorical question...

Re:If someone’s having to read your docs, it’s not “simple” by thiht on Monday June 07, 2021 @05:36PM (#27427338)
Yeah, maybe not being offended just because of the word "simple" would be a good start.
Re:If someone’s having to read your docs, it’s not “simple” by Dashron on Tuesday June 08, 2021 @02:36PM (#27439088)
I didn't use the word offended.

Feeling offended is a very different emotion than feeling alienated.

Re:If someone’s having to read your docs, it’s not “simple” by lovegoblin on Monday June 07, 2021 @11:39AM (#27423850)
> Simple is ... not the opposite of hard.

...yes it is? The word has multiple meanings.

> free from complexity or difficulty [https://www.merriam-webster.com/dictionary/simple]

> involving minimal difficulty or effort [https://www.merriam-webster.com/thesaurus/simple]

etc

Re:If someone’s having to read your docs, it’s not “simple” by thiht on Monday June 07, 2021 @01:04PM (#27425001)
When we say "simple", we use it as a way to say "not complex". If we want to say "not hard", we say "easy".

Words should be used carefully or we end up with no word to say what we mean. That's why there's literally no word meaning what we want to say by "literally".

But from context you can determine whether "literally" means "literally" or "figuratively". It's the same with "simple", you should assume it means "simple" and not "easy" in the case of a documentation where words are chosen carefully.