How to Punctuate Items Listed in a Table Cell or Unordered List

Punctuation of table cell or unordered list items presents a special problem in technical writing since more often than not such lines include technical specs. Punctuation questions, like whether to end each line with a period or not, acquires a special significance since Parallelism “Parallelism” is one of those cardinal rules in technical writing. In…

Read More

Should You Use Text or Video in Your Posts & Publications?

We need to make a lot of choices every day. The familiar refrain of “paper or plastic?” represents one such mundane choice that we are faced with when we stop by at a supermarket for shopping. Another choice I’m faced with on a regular basis is “text or video” in sharing useful technical writing tips…

Read More

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