Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me
You are here: Home / Career Development / FrameMaker comes full circle with version 12

FrameMaker comes full circle with version 12

May 9, 2015 by RDesprez 5 Comments

Tweet

When I recent­ly start­ed using Adobe’s lat­est ver­sion of FrameMak­er, I felt déjà vu.

Back in the 2000, when I used FrameMak­er 6.0, I wrote con­tent in the soft­ware pro­gram and then con­vert­ed it to Web­Help using Quadralay Cor­po­ra­tion’s Web­Works, which was inte­grat­ed into FrameMak­er at the time. I tagged my con­tent in FrameMak­er using para­graph styles and Web­Works duti­ful­ly con­vert­ed those para­graph styles into HTML code. At the time I worked for a com­pa­ny that want­ed me to cre­ate a help project that took advan­tage of sin­gle sourc­ing. Some­how, I fool­ish­ly accept­ed the task of fig­ur­ing how to cre­ate Web­Help out of FrameMaker.

The project had its share of chal­lenges. The main one was that Web­works’ Java-based ver­sion of the help was not reli­ably appear­ing on users’ screens, osten­si­bly due to issues with the Java Run­time Envi­ron­ment. After con­sid­er­able hair pulling, I dis­cov­ered that Web­Works could out­put a JavaScript ver­sion of the help. Dis­as­ter averted!

In 2005, Adobe acquired Macro­me­dia and with it Robo­Help, its help author­ing tool. A few years lat­er,  Abobe offered its Tech­ni­cal Com­mu­ni­ca­tions Suite, which pro­vid­ed tighter inte­gra­tion between FrameMak­er and Robo­Help. For the first time, you could write con­tent in FrameMak­er and then have con­tent con­vert­ed to help by Robo­Help. Sort of like the FrameMak­er and Web­Works integration.

But not exact­ly. As Robo­Help has been around since 1991, much of its user inter­face looks like a movie from the 1990s. FrameMak­er is no spring chick­en either. Togeth­er, the user is faced with two respect­ed but old and bloat­ed soft­ware pro­grams that are forced to com­mu­ni­cate for the first time. The com­mu­ni­ca­tion worked but it was­n’t ide­al. For exam­ple, when I linked the help files in Robo­Help to the orig­i­nal FrameMak­er files, the updat­ing process was slow and some­times incon­sis­tent. If I made an edit to a FrameMak­er chap­ter, Robo­Help did­n’t always detect the change. And the updat­ing process was­n’t exact­ly sprightly.

Fast for­ward to Adobe’s lat­est ver­sion of FrameMak­er. Ver­sion 12 enables tech­ni­cal writ­ers to cre­ate online help right from FrameMak­er. By not forc­ing users to deal with Robo­Help in the help cre­ation process, I found cre­at­ing Web­Help to be much faster than ear­li­er ver­sions when users need­ed to tog­gle between FrameMak­er and RoboHelp.

FrameMak­er 12 can cre­ate HTML5 help for mobile devices, Web­Help, EPUB files, Kin­dle files, and Microsoft HTML Help.

I have used Robo­Help for years and cre­at­ing online help direct­ly from FrameMak­er does require some par­a­digm shifts (for exam­ple, how table of con­tents are cre­at­ed). But over­all, FrameMak­er 12 makes it faster and sim­pler to cre­ate online help. A wel­come change.

Filed Under: Career Development, Help Authoring Tools, Robert Desprez | Vancouver technical writer | Blog Tagged With: FrameMaker, online help, RoboHelp, WebWorks

Comments

  1. J'Ro says

    May 18, 2015 at 4:51 am

    So do you think this is the end of Robo­Help? And would you rec­om­mend Frame?

    Reply
  2. RDesprez says

    May 20, 2015 at 3:25 am

    Hi Jerome,

    Yes, I would rec­om­mend FrameMak­er as an author­ing tool. I’ve used it for more than 15 years and it has many advan­tages over Microsoft Word.

    I’m not sure that this fea­ture rep­re­sents the demise of Robo­Help, which offers more con­trol than FrameMak­er over the table of con­tents, adding Cap­ti­vate videos, and so on. 

    If I was to spec­u­late why this online help fea­ture was includ­ed in FrameMak­er, I’d say it is due to online help tools like Mad­Cap Flare. I’ve used Flare and it per­mits authors to eas­i­ly cre­ate PDFs and mod­ern look­ing online help. Mad­Cap is aggres­sive­ly mar­ket­ing Flare and I’m sure it is chal­leng­ing Adobe’s once dom­i­nant mar­ket posi­tion. I have no stats to back this up though.

    Thank you for your comment.

    Robert

    Reply
  3. Paul Noga says

    May 22, 2015 at 10:14 am

    I can­not see FrameMak­er pro­vid­ing con­text-sen­si­tive help func­tion­al­i­ty (as Robo­Help does). In addi­tion, I can’t see FM offer­ing the “hot-map­ping-zones” func­tion­al­ty (as Robo­Help does).

    Reply
  4. Dieter Gust says

    May 23, 2015 at 6:32 pm

    FM sup­ports con­text sen­si­tive help:
    It cre­ates the .h file that lists the con­tents of the Top­i­cAlias Mark­ers (MapId/TopicId) togeth­er with auto gen­er­at­ed Map num­bers begin­ning with 1. But the expla­na­tions in the online help is total­ly insufficient.
    FM knows hot spot areas for cre­at­ing image maps.
    So what is miss­ing except a real help information?

    Reply
    • RDesprez says

      May 23, 2015 at 9:31 pm

      Hi Dieter,

      Thank you for commenting.

      Yes, I agree. The FrameMak­er help is dis­ap­point­ing. I just wrote a blog entry about it: https://robertdesprez.com/2015/03/22/framemaker-12-documentation-disappoints/

      Robert

      Reply

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

About Robert Desprez

I have worked as a Vancouver technical writer for more than 20 years, working at some of British Columbia's largest high-tech firms. I have served in leadership positions for the Society for Technical Communication and have worked as a writing instructor at Vancouver's Simon Fraser University.

Robert Desprez Follow 1,187 242

Vancouver Technical Writer. Former Instructor at Simon Fraser University. Dog Lover. Coffee Drinker. Tennis and Piano Player.

robert_desprez
robert_desprez avatar; Robert Desprez @robert_desprez ·
31 Oct 1984117857001807900

Image for twitter card

Meta, Google, and Microsoft Triple Down on AI Spending

Three of the biggest US tech companies reported record profits and record infrastructure spending on Wednesday, fuelin...

www.wired.com

Reply on Twitter 1984117857001807900 Retweet on Twitter 1984117857001807900 0 Like on Twitter 1984117857001807900 0 Twitter 1984117857001807900
robert_desprez avatar; Robert Desprez @robert_desprez ·
31 Oct 1984117264174739613

Reading The Coming Wave

Image for twitter card

The Coming Wave

An urgent warning of the unprecedented risks that AI and other fast-developing technologies pose to global order, an...

a.co

Reply on Twitter 1984117264174739613 Retweet on Twitter 1984117264174739613 0 Like on Twitter 1984117264174739613 0 Twitter 1984117264174739613
robert_desprez avatar; Robert Desprez @robert_desprez ·
28 Oct 1983003898656047193

Image for twitter card

Amazon to cut as many as 30,000 corporate jobs, reports say | CNN Business

Amazon is laying off as many as 30,000 corporate employees beginning tomorrow, reports say.

www.cnn.com

Reply on Twitter 1983003898656047193 Retweet on Twitter 1983003898656047193 0 Like on Twitter 1983003898656047193 0 Twitter 1983003898656047193
robert_desprez avatar; Robert Desprez @robert_desprez ·
2 Oct 1973868879261938086

Image for twitter card

The magic of AI is giving way to complaints about workslop

A team from Better Up Labs and the Stanford Social Media Lab define workslop as ‘AI generated work content tha...

www.theglobeandmail.com

Reply on Twitter 1973868879261938086 Retweet on Twitter 1973868879261938086 0 Like on Twitter 1973868879261938086 0 Twitter 1973868879261938086
Load More

Recent Blog Posts

  • Using ChatGPT to read smarter
  • ChatGPT: The AI-powered proofreader
  • Four ways Confluence could be better
  • First impressions of MadCap’s purchase of IXIASOFT

About Me

Robert Desprez I have worked as a Vancouver technical writer for more than 20 years, working at Kodak, Boeing, Teck Resources, and FortisBC. In addition, I have worked as a writing instructor at Simon Fraser University in Vancouver.

Contact Me

Robert Desprez Com­mu­ni­ca­tions Inc.
North Van­cou­ver, British Columbia
Canada
Phone: 604–836-4290

  • Email
  • LinkedIn
  • Twitter

Copyright © 2025  · Robert Desprez Communications Inc.