How to Create a List of Tables in MS Word

Follow these steps… (1) Give all your tables a caption. (2) Click your cursor at where you’d like to place your List of Tables. Its traditional location in a technical document is right after the Table of Contents (if any) and after the “List of Figures” (if any). (3) Select Insert > Reference > Index…

Read More

How to Create a List of Figures in MS Word 2003

© 2010 Ugur Akinci (1) Give all your figures a caption. (2) Click your cursor to where you’d like to place your List of Figures. (NOTE: Microsoft calls the same list “Table of Figures” unfortunately. What if you need to create a list of tables? Should you call that a “Table of Tables”?) The traditional…

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

How to Create a Pie Chart with Adobe Illustrator

© 2010 Ugur Akinci Did you know that you can create 3-D pie (and other types of) charts with Adobe Illustrator? Here is how: (1) Select the pie chart tool from the tool bar and double-click it to display the Graph dialog box: (2) Enter 200 px for both Width and Height of the chart…

Read More

How to Write a Terrible Technical Document

© 2010 Ugur Akinci There are many ways to write a really bad technical document. Let’s look at some of the foolproof ways to accomplish that. (1) Obtuse or indecipherable document title Instead of calling your document “Mark-24 User Manual”, use one of the following titles: “M24/X-768 Set-5.3 Rev. 4.4.6.8 OPS-VII H4G5” Or “The All-Comprehensive…

Read More

How to Review a Grant Proposal

© 2010 Ugur Akinci Reviewing grant proposals properly is as critical a function as writing them. What good is it to spend six months on a grant proposal only to have it trashed in the hands of an irresponsible reviewer? Never forget that when you review a proposal you sometimes hold the career of another…

Read More