DEV Community


Discussion on: How to remove condescending language from documentation

codemouse92 profile image
Jason C. McDonald

This article inspired me to write a "Word/Phrase Hit List ☠️" for editing my upcoming tech book. I'm scrubbing out as many instances of the following as possible and reasonable:

  • "of course"
  • "obvious"/"obviously"
  • "naturally"
  • "just"
  • "merely"
  • "only"
  • "simple"/"simply"
  • "easy"/"easily"
  • "basic"/"basically"
  • "clear"/"clearly"

There are rare exceptions, but in general, these words die. ;)