Archive for 2010
How to Publish a MS PowerPoint Presentation to a Web Site via OpenOffice Impress
If you tried it, you know it: publishing a MS PowerPoint presentation to a web site is not easy. PowerPoint has a direct Broadcast Slide Show button which creates an html link to post and share but that does not work well either (click on image): Here is one solution I’ve developed by using OpenOffice…
Read MoreMy Mom – The True Test of My Abilities as a Technical Communicator
As a technical communicator I’m sometimes stuck with situations that I can’t handle. Example… I have a smart mom. She is approaching 80 God bless her yet she is on the Internet. I really admire her tenacity and her lack of techno-phobia. Although she does not have a college degree, she did what millions of…
Read MoreThe True Scope of a Localization Project
What is Localization? Some technical communicators think that “localization” is one and the same thing as “document translation.” Localization certainly encompasses translation but that’s not all. A localization project can include a lot more than just translating a user manual or two. Just consider the following list of BOM (Bill of Materials) introduced at a…
Read MoreHow to Explain Things "In Other Words"…
When writing to explain and convince, it’s sometimes necessary to reexplain things bu using different words and phrases. It is unrealistic to expect people to understand what you’re talking about the first time you write about it. Sometimes you need to explain the same concept or idea multiple times and in different ways to make…
Read MoreHow to Write a Corporate Form 10-K Annual Report
Annual Report All U.S. companies that issue publicly traded stock shares must file an Annual Report with the U.S. SEC (Securities and Exchange Commission) by law. They have to disclose their financial dealings, strengths and vulnerabilities, by filing Form 10-K every year. Another name for this form is the “Annual Report.” If a company has…
Read MoreHow to Avoid Obfuscation when Writing a Corporate "Tagline" or Mission Statement
Writing a corporate mission statement is both science and art. Movies Movies come with taglines that summarize the story in a hurry. ALIEN (1979): “In space, no one can hear you scream.” ERIN BROCKOVICH (2000) : “She brought a small town to its feet and a huge corporation to its knees.” FARGO (1996): “A lot can…
Read MoreHow to Write an Executive Summary
An executive summary is pretty much what the name suggests: it is a one- or two-page summary of much longer work. Its intended audience is executives and upper management staff who have very little time to read the whole work. There are two main types of executive summaries: those written for reports and those written…
Read MoreHow 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 MoreShould 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