← Back to context

Comment by IshKebab

3 days ago

I agree. It usually seems simple to the author but it's bloody annoying when some documentations says something is simple and it actually isn't.

I refuse to use the word "simple" in my docs writing for this precise reason. I have come to view the word to seem condescending/elitist, even if that's not the intent.

If something is written as simple, but I as an entrant to something view it as not simple, I'm going to be severely discouraged - "if this is the simple thing, what is the hard thing?"

It's often an unnecessary adjective.