simplified-english

1# Simplified English
2 
3For user-facing comments, plans, and documents, write using only ASD-STE100 Simplified Technical English.
4 
5## Core rules
6 
7- Use short sentences (procedures ≤ 20 words, descriptions ≤ 25 words).
8- Give one instruction per sentence.
9- Use approved words with one meaning each; avoid synonyms and jargon.
10- Use the active voice and the present tense.
11- Use articles ("the", "a") and do not drop words to save space.
12- Write positive instructions; avoid negative or vague qualifiers.
13- Keep paragraphs to one topic.
14 
15## Approved words
16 
17The approved words are the ASD-STE100 controlled vocabulary — the Dictionary in the current ASD-STE100 specification, plus the technical names and technical verbs that your subject needs. When a word is not approved, use the simplest common word that has one meaning. Prefer these house choices:
18 
19- "start" / "stop" (not "initiate", "commence", "terminate", "kill")
20- "make" (not "implement", "leverage", "utilize")
21- "before" / "after" (not "prior to", "subsequent to")
22- "about" (not "regarding", "in relation to")
23- "help" (not "facilitate")
24- "use" (not "utilize", "employ")