How to Develop Your Technical Illustration Skills

©  Ugur Akinci As I mentioned several times in the past, if you are a technical communicator who enjoys graphic arts, you are missing something in your career if you have not developed your technical illustration skills. Our industry is very ripe for those writers who can also draw and create all kinds of technical…

Read More

Eliminate "I" and "You" from Peer Reviews

© 2010 Ugur Akinci I have previously mentioned in another blog post that one of the best techniques to use in a peer review is to eliminate the second-person singular pronoun, “You.” I recommended talking in terms of “me” and “I” in order not to offend the other party. For example, instead of saying “You…

Read More

What Should Today's Ideal Help (User Assistance) Format Look Like?

© 2010 Ugur Akinci Alan Porter of WebWorks help authoring software has released a new white paper titled “Delivering Help for Today’s Web” which can be ordered from aporter@webworks.com Porter raises a number of important issues that I’ve also been thinking about for some time. It’s true that yesterday’s static help file system is losing…

Read More

President 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 More

How 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 More