Technical writing should produce clear and concise documentation – yet, everyone has seen examples of documentation that is imprecise and ambiguous. Here are some easy-to-follow writing tips.
The complexity of the systems and procedures technical writers describe can get in the way of clear and concise writing. A consistent choice of words can contribute to clarity.
Adjectives can cause ambiguity
Imagine your developer supplies you with a text titled "program-based utilities". The developer certainly knows what is meant, but will the reader? So, the utilities are based on something, but what? There are several possible interpretations of the text and it is up to the writer (you) to work out which of them is correct and phrase the documentation accordingly.
Here are the questions you might need to ask your developer, who has supplied you with the hyphenated double adjective.
(1) Singular or plural: Are the utilities based on one program or on more than one?
(2) "A/an" or "the": Are the utilities based on a program or programs in general or are they based on a specific ...
Read more after login
tekom members can log in directly with their "My tekom" access data.
You are not yet a tekom member, but would like to read one or more articles in full? Then you have the opportunity to register on the internet portal of the technical journal 'tcworld' without obligation. Once you have registered, you can select any three specialist articles and view them in full for a period of two months. The selection will then be deleted and you can select three new articles for the next two months.
As a tekom member you benefit from the following advantages::
- Online access to all articles of the trade magazine 'tcworld magazine'
- Exclusive specialist articles from all areas of technical communication
- Regular new articles from over 300 authors
- The technical journal 'tcworld magazine' as a printed edition
- Reduced admission prices to tekom conferences
- Membership fees for tekom publications
- Access to 'my tekom', the web forum with job offers / job requests, appointments, expert advice, service provider file and much more
Login
Registration
Promised: The trade magazine 'tcworld magazine' is the best we have. And we don't make the choice easy for ourselves. Every month, the editorial staff of the technical journal 'tcworld magazine' publishes the latest articles by renowned authors. This demanding selection is available exclusively to members of tekom (as usual, including the printed edition).
The trade magazine 'tcworld magazine' stands for intelligently prepared specialist articles, texts written to the point, informative content, surprising insights, international perspectives and communicates technical communication in an understandable, fast, clear and uncomplicated way - exclusively for you.