re: How to remove condescending language from documentation VIEW POST


I would omit adjectives because they are superfluous to technical documentation.
I never thought about how they affected tonality.

Before Grammarly reported tonality I had no idea what tone my writing came across since I write in draconian style treating every textbox as documentation.


Avoid using adjectives is an argument I'd accept somewhat. I hate when it is done in journalism, because this mixes content and comment.


I had a journalism class in college over a decade ago for copywriting and they taught you to avoid adjectives. So this certainly where it started for me.

code of conduct - report abuse