Which Text Editor to Use for Technical Writing – Adobe FrameMaker or Microsoft Word?

”Technical

Most professional technical writers use Adobe FrameMaker for complicated technical documents


© 2008-2010 Ugur Akinci
Technical writers have been asking this question to themselves for the good part of the last 15 years.
The short answer is this – if you’re writing a short memo, letter, or a short document, MS Word would be just fine. No problem. I use MS Word in that fashion all day long.
But if you are writing a book, something over 50 pages and with figures, tables, footers, index, references, multi-level paragraph numbering, you’d better stick with FrameMaker.
I’ve seen 50 pages documents going haywire with MS Word. And I’ve also seen 1,000 page manuals perfectly structured when written in FrameMaker.
I heard of a commercial airline manufacturer here in the United States and a European car company in Germany using FrameMaker to generate their maintenance and service manuals at their respective plants.
And I understand that both companies regularly update their manuals each running over 10,000 pages (I guess not printed but online “pages”) thanks to FrameMaker. Try doing that with MS Word on that scale and you’ll need nerves of steel to keep everything intact.
It all comes down to this: FrameMaker is a very mature and solid product that can handle structural complexity very well. You can have as many nested numbered lists as you like without any strange errors popping up in your numbering system.
With Word, on the other hand, you’d better keep your numbering scheme to as few levels as possible.
FrameMaker also has a great Book compilation functionality that works every time and creates perfect books out of individual chapters. Word has a similar outlining and book-compilation functionality (Master Document) that does not work that dependably.
FrameMaker is a great single-sourcing platform with its own built-in XML engine. It works very well with WebWorks to compile help files out of source document files. The standard edition of WebWorks comes with FrameMaker. MS Word can also be used for single-sourcing purposes but only with the help of additional third-party plug-ins and programs.
Another FrameMaker feature I like is the easy way in which you can insert running headers and footers, the kind you’d see in a phone book or catalog. There is no easy straightforward way to insert such “runners” in Word.
Having said all that, I still think MS Word has the upper hand in revising and marking a document. Word’s “Markup” functionality which you can access through the Reviewing toolbar is simply without a match. That’s why it’s used so frequently in the business world, to review and mark-up all kinds of office correspondence.
(You can approach that level of excellence only if you convert your FrameMaker document into PDF, then review and mark it up in Adobe Acrobat Professional — which will cost you extra.)
CONCLUSION:
FrameMaker has made significant inroads into the technical writing community whereas the much more affordable MS Word continues its dominance in the business office world.
Sometimes which one you end up using does not even depend on your personal choice but corporate guidelines.
However, as a technical writer, you should at least be aware of the major differences between these two powerful text (and layout) editors, as outlined above.
You should, for example, be aware of what you’re getting into if the job at hand is to create a 1,000 page manual with multiple page-templates in MS Word.
In situations like that knowledge is not only a good thing; it’s an excellent thing.

7 Comments

  1. Ron O. on February 9, 2009 at 10:57 am

    I know how nimble FrameMaker can be, and I understand why Word has such a bad reputation for working on big docs (been there). But with Word 2007 and DOCX, I’ve had much better results. I’m starting to trust it with larger files. Recently, I’ve been working on a doc of close to 300 pages and it’s been great (albeit, a TOC and chapter headings only). Is this posting a comparison of Word 97-2007 vs. FrameMaker or is it a comparison of Word 2007 (only) vs. FrameMaker? I can understand the author wanting to cover 97-2007; I’m guessing the majority of people do not have the latest version of Word.



    • admin on February 9, 2009 at 3:15 pm

      Ron, you’re absolutely correct. This article basically targets MS Word 2003. I’m very pleased to hear that Word 2007 is much better in handling long and complex documents. Although I doubt if that’s a news item good enough to switch someone already using FrameMaker back to Word, I think Word 2007 deserves a second look. We’ll revisit the issue in the near future. Thanks for your informative comment and for reading TCC.



  2. ccardimon on February 27, 2009 at 2:31 pm

    I use MadCap Flare. It works quite well.



  3. admin on February 27, 2009 at 2:49 pm

    Yes, I hear good things about MC Flare as well although I do not use it personally at this point. Here is a link for those readers who are interested to find out more about Flare: http://www.madcapsoftware.com/products/flare/



  4. davidmathiraj on March 2, 2009 at 7:03 am

    Why doubt MS-Word?
    I am using MS-Word, since 1992 and evaluated Frame Maker also and appraised MS-Word after thorough scrutiny. Till this time I have personally created maximum number of reports, manuals, brochures, etc. I did faced problem, because of the human error in following the rules of the package. Otherwise, the outline facility, I enjoyed and still enjoying, while I create documents and every one is surprised about the time frame.
    It is my humble opinion, in my experience MS-Word is BEST compared to Framemaker.



  5. Walter Hanig on July 17, 2009 at 3:01 pm

    Word makes simple things simple and hard things hard. With FrameMaker, it’s just the opposite



  6. Ersin Akinci on April 13, 2010 at 5:53 pm

    Here’s a flame war starting question about the *long term* stability of Microsoft’s formats, not just how crashproof they are: is it significant that the open source ODF spec is OASIS/ISO approved and will that give it a critical advantage over OOXML? Lots of European and Asian governments are switching over to OpenOffice.org over their fear of vendor lock in; on the other hand, how does OOo’s performance stack up against Word and Framemaker? Some studies have been done, but none are very convincing and most are outdated (between OOo and Word, at least; I don’t know any comparative studies between OOo and Framemaker).
    Great story =)!