Technical Writing Best Practices for Engineers

Chapter 2 · Practice 1 of 4

Focus each sentence on a single idea

From Write clear sentences

Why it matters

Google's course on short sentences says: "Focus each sentence on a single idea, thought, or concept." It also notes that shorter documentation reads faster and that short sentences communicate more powerfully than long ones.

Before:

After:

Three sentences, three ideas, and the instruction is no longer buried at the end.

Do

  • Split sentences that contain two or more ideas
  • Put instructions in their own sentence

Avoid

  • Long sentences chained with "which", "and" and "so"