WIN $150 GIFT VOUCHERS: ALADDIN'S GOLD

Close Notification

Your cart does not contain any items

Technical Documentation Best Practices - Writing Clear and Helpful User Assistance

Writing Rules, Tips, FAQ

Marc Achtelig

$53.95   $45.82

Paperback

Not in-store but you can order this
How long will it take?

QTY:

English
Indoition Publishing E.K.
25 October 2020
"Users want manuals that are easy to read, with short sentences, simple words, and unambiguous instructions. Unfortunately, writing plain language is much more difficult than writing overblown instructions that only an expert can understand. Writing complex texts is simple-writing simple texts is complex.

This book shows you how to write simple user assistance rather than complex user annoyance. As it's a book about stating your message clearly, it also states its own messages clearly. It's free of boring theory and free of highbrow grammar terms, but gives you clear recommendations and catchy examples that you can easily remember and apply to your own work.

Topics covered:

General technical writing principles that make your texts plain, simple, and easy to understand. On the topic level:

Rules for writing ""Concept topics,"" ""Task topics,"" and ""Reference topics."" On the paragraph level:

Rules for writing the standard elements that form a topic, such as headings, subheadings, procedures, lists, tables, warnings, notes, tips, examples, cross-references, and links. On the sentence level:

Rules for building plain and unambiguous sentences. On the word level:

Recommendations for using simple words. Spelling and punctuation FAQ. Grammar and word choice FAQ. Standard terms and phrases."
By:  
Imprint:   Indoition Publishing E.K.
Dimensions:   Height: 229mm,  Width: 152mm,  Spine: 18mm
Weight:   467g
ISBN:   9783943860146
ISBN 10:   3943860140
Series:   Technical Documentation Best Practices
Pages:   348
Publication Date:  
Audience:   General/trade ,  ELT Advanced
Format:   Paperback
Publisher's Status:   Active

See Also