If someone’s having to read your docs, it’s not “simple”

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.

[ Parent | on HN ]

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...

[ Parent | on HN ]

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.

[ Parent | on HN ]

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.

[ Parent | on HN ]