I would say that anyone who requires introduction to the rules of grammar and conventions of clarity at this level is better off letting someone else write the documents. This is hopeless.

Well-intended, well-executed. but hopeless. Against basic number disagreement we contend in vain. Singular and plural.

The secrets to clarity in text are simple

  • Don’t make readers hold any more in their heads than necessary, e.g. relative pronouns, references to more than one entity
  • Stick as closely to subject-verb-object as possible
  • Alternate long and short sentences
  • Avoid chumble like “in connection with,” use “about”

I take responsibility for all documentation at every job I’ve had.

If you’re going to do a significant amount of writing and you can plan over years then acquire a second language as different from English as you can to get some perspective. I speak German and Vietnamese, and in the past spoke Russian, Cantonese, and several others. This enhances awareness of grammar.

I could go on with this a long time but I’m not trying to hijack your post.


American Software Developer living in Vietnam. Classical musician (guitar, woodwinds), weightlifter, multilingual, misanthrope • XY

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store