Tech writing is terrible.

/Tech writing is terrible.

There’s this frustrating vicious cycle in tech that goes:

  1. SME is bad at writing.
  2. SME has to write doco for exec.
  3. Exec gets frustrated by garbage bafflegab stream-of-consciousness nonsense and pushes back.
  4. SME assume exec is “stupid” and can’t understand “technical documents”.
  5. SME rewrites doco to read as generic anodyne boilerplate.
  6. Exec accepts document because at least it’s comprehensible.
  7. SME learns wrong freakin’ lesson.
2018-07-29T10:19:33+00:0027th July, 2018|Tags: tech, writing|Comments Off on Tech writing is terrible.