Posts Tagged ‘English’
The Discipline of Punctuation in Technical Writing
© Ugur Akinci Today let’s talk about the discipline of punctuation Technical writing is nothing if it’s not about discipline, precision and consistency. That’s how tech writers impose order on disorder. One of the most basic we impose that order on an otherwise unruly collection of information is the application of stringent punctuation rules. When…
Read MoreSurvey: British Office Workers Hate Business Speak
If you’re miffed to hear hackneyed expressions like “think outside the box” you’re not alone: a lot of office workers in Britain reported they also can’t stand the expression, according to a British survey of 2,000 cubicle dwellers. Tweny five percent of those surveyed ranked “blue sky thinking” and “hit the ground running” as number…
Read MoreThe Difference a Comma Makes
© Ugur Akinci Technical writers must watch their punctuation like a hawk because of the dramatic difference a misplaced punctuation mark makes. Here is a great example from the Understanding Uncertainty web site: “how unlikely the result is due to chance” versus “how unlikely the result is, due to chance” Click here to read the…
Read MoreThe Politics of Plain English vs. Obfuscation
Usually people don’t write in plain English because they don’t know any better. Sometimes a banker, an engineer, a doctor will write a business letter or a technical document in a way that he or she best knows how – by using jargon and long-winded sentences; clauses awash in passive voice and unparallel construction, with…
Read MoreOn the Idea of “Product Evangelist” in Technical Communications
I love product evangelists for two good reasons: (1) I love software products. I have no idea how we lived back in the 60s and 70s without any software doing all these wonderful things on our desktops, laptops, and mobile devices. (2) I like and admire the product evangelists that I’ve met both in person…
Read MoreA Great Government Web Site Dedicated to Plain Language: http://www.plainlanguage.gov
© 2010 Ugur Akinci President Barack Obama ushered in a new age in technical communications by signing the “Plain Writing Act of 2010” on October 13, 2010. According to this, within one year, all U.S. government agencies are supposed to generate only documents written in a plain language. I found this excellent federal web site dedicated to the Plain…
Read MorePresident Obama Signed Plain Writing Act of 2010
© Ugur Akinci A new era has begun in the United States when President Obama signed the Plain Writing Act of 2010 on October 13, 2010. According to this, all U.S. government agencies and offices are now mandated to create all their documents and communications in clear, uncomplicated English. Here is the text of…
Read MoreHow to Avoid Dangling Participles in Your Technical Writing
© Ugur Akinci “Dangling Participles” is the kind of writing error you should avoid in your technical documents because it changes the meaning of a sentence and often leads to unintended humor. But first — what is a “participle”? PARTICIPLE is the present- or past-participle form of a verb which is used as an ADJECTIVE.…
Read More4 Levels of Editing in Technical Writing
Writing is re-writing; that is, editing. Technical editing is a crucial part of all technical writing projects. But we have to remember there are multiple levels of technical editing which makes the task all the more challenging. LEVEL 1 EDITING Spec Editing. Does the document satisfy all the macro requirements specified in the Documentation Plan?…
Read More
Localization – Problem with Translating Phrasal Verbs – English-French Examples
Introduction There are many problems faced by translators when they try to translate from English to French. Language is not the only thing that affects the quality of translation; cultural context also plays a role in how texts work in one language and not in another. This is because languages do not work in isolation…
Read More