Main | May 2008 »

April 2008

April 21, 2008

Microsoft Word Versus Adobe FrameMaker For Creating Professional Documents

I use Word and FrameMaker to write creatively about technology. Both tools can produce professional documents but they each have their advantages and disadvantages.

Word is:

  • Easy to learn
  • Not as expensive as most desktop publishing tools
  • Bundled with other applications such as PowerPoint, Excel and Access
  • Good for simple documents where there is no complex numbering or formatting
  • Great for small documents (less than 50 pages)

However, Word falls down when it comes to producing large documents. I've seen Word literally blow up documents where I had to spend hours rebuilding them from scratch. And, at 12:00 midnight while rushing to meet a major deadline, that is no fun!

There are problems with numbering too - especially with numbered procedures. If you move a numbered procedure to a different section of your document, chances are your procedure numbering will continue from the new previous procedure, and you’ll have to restart the step numbering manually.

FrameMaker has several advantages. I'll name a few:

  1. It's 99.9% bulletproof. Case in point: I was producing system documentation for a leading financial company. I had to update documents for 30 subsystems, which each subsystem being a chapter. The documents were complex with numbered headings, procedures, complex graphics and screens, and numerous cross references. Near the end of the contract, my coworker and I noticed that FrameMaker was taking a few minutes to generate the table of contents. To our surprise, we discovered the document totaled 1400 pages! I had only a few months to produce all these documents, so you can imagine I was working at top speed and multitasking like crazy - and FrameMaker crashed only once.
  2. You can create multiple versions of a document quickly and easily. For example, with FrameMaker’s conditional text feature, you can single source printed documents for different audiences.
  3. Cross referencing is very versatile. You can cross reference within your document and across documents. And, you can customize the cross reference formatting to include the chapter number and quotation marks, and include text before the page number. For example, your cross reference can say: See Chapter 1, "Introduction" on page 10.
  4. You can use variables to customize complex numbering series. For example, your procedures can have numerical numbering for the main steps and alphabetical numbering for the sub-steps.
  5. You can customize and save table formats. For example, you can create a table for your procedures where one column has the step number, and the other column has the action and result.
  6. You can put a logo or a graphic in a paragraph style. This is very useful if you need a "hazard" symbol in a warning or an "exclamation mark" in an important note.

FrameMaker 8 has some very powerful new features:

Unicode support. You can produce documents in Russian, Greek, Turkish and other languages that use non-Latin alphabets.

Rich Media support. FrameMaker 8 supports Flash and Acrobat 3D, which makes it possible to produce interactive PDF files where you can include animation and voice over. Now, you can create much more engaging online documentation.

Tracking text changes. Like Word, you can now track text changes easily. And, you can use the History palette to highlight, accept, and reject text changes, and to undo multiple changes.

Dita Support. You can create and distribute topic-oriented information in XML and create DITA maps.

Microsoft Office 2007 support. You can import content created in Word and Excel 2007.

Although FrameMaker is expensive and has a huge learning curve, I vote for FrameMaker hands down because of its robustness and versatility.

Which tool do you prefer to create documents? FrameMaker or Word?

Let me know in the comments…

April 17, 2008

Website or Blog?

A lot of my friends and colleagues have websites; and lately, I’ve been feeling like an oddity not having one. After all, everyone has a website, right? Besides, a website can help me publicize my business, increase my sales, establish my online presence, make new connections, and do business all over the world without leaving my office.

Recently, I asked a well-respected and established entrepreneur if I should get a blog. He told me a blog will be a waste of my time because I’ll spend too much time blogging and not enough time establishing my business. So, I took the plunge and began to strategize my website.

My website designer friend is busy until the end of May because she is in very high demand. I cannot wait until May. I want my website now, so I decided to design it myself. I soon realized that I don’t have a clue on how to design my website. I have so many questions:

What colour scheme should I use? Should I use red, white and blue? Red, grey and white? Or, brown, green and white? I surfed the internet to find a colour scheme I like. The more examples I saw, the harder it was to decide.

How do I design my website? I considered using web design software like FrontPage, but I don't have strong web design skills and I don’t want to spend too much fighting with technology. I checked out some websites that specialize in designing templates. There is a myriad of choices, and I got lost in a sea of confusion.

What navigation system should I use? Should my navigation bar be on the left or at the top? Should I use square buttons? Round buttons? Links? Smiles? I don’t want too many special effects like spinning buttons or flashing arrows. All I want is a plain, simple website. At this point, a few hours passed; but I pressed on.

What background should I use? This is easy to decide. I don't want a flashy or colored background. I want the text to be easy on the eye so my visitors can read it quickly and easily.

Then, I have to think about page design, layout, fonts, typefaces, graphics, images, navigational rules... And, I haven't even thought about the content. It was the end of the day, and I still haven’t design a single pixel of my website.

Discouraged, I sank in my chair as I stared at my blank computer screen.

The next day, I went to an excellent seminar on how to get free publicity for your business. The trainer recommended we start a blog! After the seminar, I spoke with him and told him my dilemma. He recommended that I read the book Blog Wild! by Andy Wibbels. I hurried to the bookstore and snapped up the last copy. (I guess it's selling fast.) I read it, and I was sold. I decided to start my blog.

I checked out blogging software and was shocked as to how easy it is to use. All I have to do is sign up, choose the layout and design, and boom! I'm ready to blog. Just like that! It took me five minutes. And, I don't have to design the template. All I have to do is focus on creating great content, and I love it!

Who knows, I may get a website one day - but not today.

Want an immediate online presence? Start a blog. Now.