Technical Writing
Adobe TCS3 is here with new XML and Social Media features!
© 2011 Ugur Akinci I’m excited to hear that Adobe’s Technical Communication Suite 3 is introduced with exciting built-in DITA/XML and social media/networking features. I understand both FrameMaker 10 and Robohelp 9 are being shipped as we speak. Here is a great intro by Adobe Senior Product Evangelist RJ Jacquez. It looks like this version…
Read MoreHow to Name Files in a Technical Documentation Project
© 2011 Ugur Akinci Naming files — it sounds like something easy to do, doesn’t it? But I know from experience: it can actually become a very complicated and tangled-up affair with productivity-killing consequences. The root of the problem lies in the fact that the name should make sense not only for the creator, the…
Read MoreHow to Configure Column and Header Layout for a FrameMaker Document
You can create FrameMaker documents with complex column and header layouts. I’d like to show some of those possibilities on this sample one-column document: (Click on all images to enlarge them) As you can see, this document does not have any sidebars and a sidebar is always a nice layout feature to have in a…
Read MoreFrameMaker – How to Draw Lines by Default Above or Below any Header
Imagine every time you use a certain paragraph tag in FrameMaker, you’d like to draw automatically lines (single, double, etc.) above and/or below that header or piece of text. You can do that easily by using the ADVANCED tab in PARAGRAPH DESIGNER. Follow these steps: (1) Open your FrameMaker document: Let’s imagine you’d like to…
Read MoreThe Value of Judging Technical Documents as a Juror at STC Competition
© 2010 Ugur Akinci I love to be a judge at STC’s annual technical documentation competitions. This year is the fourth time I’m serving as a judge in my local chapter’s (Wash DC) annual technical document competition. Twice I had the honor to serve my local chapter as a Lead Judge. In other two times…
Read More7 Great Tips to Edit Your Own Document
It’s best to have a colleague or an outside reviewer to read and edit your technical or business documents. But sometimes you might now have that luxury and you may be all alone. So how should you edit your own stuff? I can only give you a few tips that worked for me in the…
Read MoreCorrelation is not Causality – Cell Phone Towers & Babies
Correlation is not causation This means that just because two things happen at the same time, it doesn’t mean that one caused the other. Correlation does not imply causation is a phrase used in statistics and social sciences to emphasize that a correlation between two variables does not necessarily mean that one causes the other.…
Read MoreSecrets of Good Communication – 5 Tips of Explaining Things More Effectively
Good communication is all about explain things well to others, isn’t it? Here is a wonderful little paper, available as a PDF download from TechRepublic, about 10 ways in which we can all improve the way we explains things to others. I really liked this list. My experience in life tells me that every item…
Read MoreRutger's University's "6-P Method" to Write Technical Case Studies
© 2010 Ugur Akinci The New York Times has published a very educational story about how Rutger University‘s technical writing program employs the “6-P Method” to create technical case studies. According to Peter Sorrell, an instructor at the business and technical writing program, the method consists of the following Ps: The Problem at stake, the…
Read More4 Reasons Why All Companies Should Have Terminology Management
What is Terminology Management? Terminology Management is a vital technical communication function for all corporations. Larger the corporation, more urgent is the need to have a standard catalog of terms and concepts used consistently across all levels of the organization. The goal of a terminology is to provide a set of terms that are well-defined,…
Read More