Show/Hide Toolbars

Technical Writers’ Companion

Navigation: Schreiben > Writing sections

Don’t mix subjects

Scroll Prev Up Next More

Long, continuous text can be extremely hard to read, especially when it covers various subjects. Long sections of continuous text also make it almost impossible to skim a text for specific information.

 1  Don’t mix various subjects within one paragraph. If there’s a new subject, start a new paragraph.

It’s perfectly OK if sometimes there’s only one sentence within a paragraph. Don’t combine paragraphs or add needless text only for the sake of building a “complete” paragraph.

As a general rule, start a new paragraph for each new idea, but don’t start a new paragraph for each new sentence. A good paragraph length is about 2 to 5 lines.

 2  Don’t mix various subjects within one sentence. If there’s a new subject, start a new sentence.

In procedures, don’t describe more than 2 steps in the same sentence (siehe Writing procedures).

In warnings, only mention one cause of the hazard per sentence (siehe Writing warnings).

Alle Abschnitte ein- / ausblenden

Examples    1 
Examples    2 

 

Add labels (subheadings)

Structuring: Split complex information

© indoition publishing e.K., all rights reserved – Imprint and Terms of Use | Privacy Policy