error · Section 4: Sentences

Rule 4.1: Write short and clear sentences

Write short sentences with clear structure that give accurate instructions and information. In procedures, give instructions directly to the reader in the imperative form; in descriptive text, give each sentence only one topic and build up information gradually across the sentences that follow, and never write abstract statements that omit the accuracy the reader needs.

What a checker looks for

A clear deviation from the rule.

  • Flag long, convoluted sentences that pack multiple sequential actions or unrelated clauses together instead of being broken into short, direct steps or single-topic sentences.
  • In descriptive text, flag any sentence that contains more than one topic, subject, or idea.
  • In procedures, flag descriptive-style or indirect phrasing used instead of a direct imperative instruction.
  • Flag abstract statements that do not tell the reader the required action or specific fact (e.g. a bare requirement or a vague claim of change with no specifics).

What this rule does not cover

  • A sequence of short, single-topic sentences that each build on the previous one is the compliant pattern for descriptive text, not a violation.

How to fix it

Split multi-action or multi-topic sentences into a vertical list of imperative steps (procedures) or into separate single-topic sentences that build on each other (descriptive text). Replace abstract statements with concrete instructions or specific facts and values.

Constraints on the fix

  • Do not drop any information when splitting a sentence.
  • Keep procedural text in imperative form and descriptive text in descriptive form — do not convert between the two writing styles.

Examples

Not STE: To remove the cover assembly (9), first remove the four screws (10) that attach the cover (11) to the housing (12), and then, after taking the cover (11) off the housing (12), remove the preformed packing (13) and throw it away.

STE: Remove the cover assembly (9) as follows: A. Remove the four screws (10) that attach the cover (11) to the housing (12). B. Remove the cover (11) from the housing (12). C. Remove and discard the preformed packing (13).

The long non-STE sentence bundles several actions; STE breaks it into a vertical list of short imperative steps.

Not STE: No leaks are permitted.

STE: Make sure that there are no leaks.

The non-STE sentence is abstract and does not tell the reader the action to take; the STE version states the required action directly.

Related rules

Where this fits in AI governance

A rule a checker can test is a rule a model can be held to. The same discipline, on the governance side of this site.

Source

ASD-STE100 Issue 9, Section 4 - Sentences, page 1-4-1.

This page is commentary and does not reproduce the standard. About this rule pack.