In my college-going days, one of my Software Engineering courses had a professor who put a sound deal of emphasis on the documentation side of programming — the written description of the solution to the problem our software was trying to solve. For a wannabe English minor with a focus in grammar like myself, his courses were a nice break from all the number- and theory-oriented course load required of the curriculum. I don’t know if said professor is still teaching, and I’m not that concerned, but he was one of the ones who left me with something worth remembering, and that was his list of words we weren’t to use in our writing, the "bad words list." (Surprisingly or not, it’s one of those handouts I’ve held onto all these years later, and I still make some kind of effort not to include those words in my writing, but then I also chuckle a bit when I notice that I have included one.) Long story short, here’s the list as last updated in November 1997:
Bad Words List
Avoid using these words in documents and on tests. They convey little
information and won’t help the reader understand.
- and/or, etc., misc.
- basically, basic
- compatible
- easy, easier, easiest, easily, simply, hard, harder, hardest
- efficient, more efficient, less efficient
- flexible, flexibility
- quickly, more quickly, less quickly, fast, faster
- maximize, minimize, optimize
- module, modular, modularity
- user friendly
- usually, generally, should, probably
- very
It is always possible to re-write the sentence to remove these vague terms.
A common speech filler; in a document, it is of the same genre as generally and is basically unclear.
These are hundreds of different opinions on this word. Say what you mean. (e.g. The computer must be able to run Doom.)
These are impossible to test. State some specific number to write a clear sentence.
Unless you are discussing furnaces, this word is vague. Say
what you mean.
Unless you are discussing gymnastics, this word is vague. Say
what you mean.
Same problem as easy.
These are precise in mathematics; in English they are basically unclear. State clearly what parameters you are trying to maximize or minimize.
These terms have a wide variety of definitions, probably more than compatible.
Are you kidding?
These are all of the same, unclear, genre. Write what you mean. Document readers hate these words.
If emphasis is needed, use a precise word.
###