Brent Site Admin
Joined: 01 Jul 2005 Posts: 800
|
Posted: Mar 31st, 2017, 12:43am Post subject: Simplified Technical English |
|
|
I am in the process of changing how I write the documentation. After reading about Simplified Technical English (STE), which is used in the aerospace industry and a few other places, I am attempting to simplify my writing so that non-native English speakers can understand it better. If you are interested in the subject, you can download a PDF document that explains the process. It includes two lists: words that are allowed, and words that are not allowed, along with substitutes for the latter.
If you want an example, here's a section from the Character and String Equates article.
Quote: | A character equate makes the use of non-printable characters more readable. You can use one where you would use a code point, a number specified by a character set.
A character equate is a single token made of two parts. The first character is the percent sign ("%"). The remaining characters are letters ("A" through "Z"). The letters can be all upper case, lower case, or mixed case.
A table of all recognized character equates follows. |
_________________ Brent |
|