Posts Tagged ‘English’
Technical & Copy Writing – Write Fast
© Ugur Akinci Writing is rewriting. That’s true. But the better you write, more enjoyable and productive the rewrite will be. And here’s my rule for writing well the first time: whether it’s a novel, ad copy, movie review, or a user’s guide, try to write AS FAST AS YOU CAN. You do your research…
Read MoreTechnical & Copy Writing – Write As You Speak
Easy does it. There is no need to write with $100 words if you’re trying to get understood by as many people as possible. EXAMPLE: We terminated our cruising episode briefly around noon to satisfy the gastronomic call of nature. BETTER: We stopped for a quick lunch. EXAMPLE: He actuated the initiation button to activate…
Read MoreA Golden Formula for Clarity in Technical and Copy Writing
© Ugur Akinci To write in simple sentences that anybody can understand, try to stick to this Golden Formula: SUBJECT + VERB + OBJECT If a sentence does not have this structure, try to rearrange the “furniture” so that it reads better and faster. ORIGINAL: The temptation to do it should be resisted. BETTER: Don’t…
Read MoreTechnical Writing – Use the Method that Untied a 400-year Knot
As a child I grew up only 90 miles away from Polatli, the site of the famous “Knot of Gordian” in Anatolia (what is today modern Turkey). This was such a tough knot that, according to the legend, for 400 years no one could untie it. Then came Alexander the Great, the world-conquering commander with…
Read MoreEliminate Adverbs and Improve Your Writing
© Ugur Akinci You can improve your writing right away by eliminating all the unnecessary adverbs. 1) Eliminate adverbs by using a correct verb instead. EXAMPLE: “He walked into the room cockily.” BETTER: “He swaggered into the room.” EXAMPLE “She walked into the room confidently.” BETTER: “She sashayed into the room.” EXAMPLE: “He looked threateningly.”…
Read MoreGoogle's Translation Service: How Good Is It?
© Ugur Akinci I’m fascinated by Google’s translation service since it promises to translate texts among over three dozen languages, including some quite exotic ones. So I decided to test the reliability of Google’s translation engine by performing a simple test. 1) I took two sentences in English and translated them into a foreign language…
Read MoreWhen to Use Jargon in a Technical Document?
Introduction As a technical writer you’ve heard this piece of sage writing advice a thousand times: you should stay away from jargon and write as you speak. It’s basic. Strunk & White said so, didn’t they? It’s true. But is this rule true ALL the time, unconditionally? No, I’m afraid it is not. Life has…
Read MoreHow to Improve Your Technical Copy by Editing "Trash Can Sentences"
You can improve your technical copy instantly by staying away from sentences with a long RANDOM list of objects. I call them “trash can sentences.” Here is a technical copy example: “The Committee will meet Thursday morning to discuss building permits, hiring practices, derivatives trading, inventory, Thanksgiving recess, product modeling, labor issues, Caribbean resorts, IPO…
Read MoreTechnical Writing – How Not to Violate the English Grammar While Trying to Be Gender-Sensitive
This is a grammar error that I see committed by some writers these days: mixing singular subjects with plural verbs and pronouns. As a technical writer you would normally never say “He enter their password.” But increasingly, in order not to commit a gender bias, I see documents that contain sentences like “the user should…
Read MoreHow to Write a Style Guide – plus, a DIRECTORY
Posted a new page on how to write a Style Guide, together with a comprehensive directory of Style Guides. Click here to read it
Read More