RE: Request of Advice

Subject: RE: Request of Advice
From: Paul Hanson <phanson -at- Quintrex -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 30 Jun 2010 11:04:46 -0500

I can relate to what Kevin and Suzette are talking about. Think of this as a side note.

I used D2H at my previous employer and when I arrived here, I was told to use RoboHelp. As any marketing lit from Madcap will tell you, the people that created Flare used to work on RoboHelp so this is really funny, to me, that Kevin mentioned D2H and Flare by name.

D2H 2.5 (does that date me??) automatically created your TOC based upon headings. A Heading 1 became a book, Heading 2 became the first topic under and I don't remember if it made Heading 3 topics in the TOC or not. Just don't remember. I got to RoboHelp and created some topics and selected the auto create menu option. Everything was in a flat hierarchy.

I needed to use heading levels came from my experience at my previous employer. I just needed to adapt that requirement to the tool I was using and, after looking at the help, and after asking in the RoboHelp forums about it, I was told, "Nope, RH doesn't work that way."

So then I moved on. I did not have a deadline pushing on me for actually quite a while when I was learning RH. That was good. I had the task of documenting an application with 20 icons across the top, each calling a window and multiple sub-windows under each icon. I frequently use those same topics, though they have now been transformed from Word/RTF to HTML and massively *MASSIVELY* been rewritten.

Happy Friday. <grin>


Kevin wrote:

HOWEVER... a writer who's never seen the particular tool before will necessarily bring to it the approaches and experience s/he's had with other tools.

So, there they are, 7 hours after arriving at your company, dutifully cranking out their first page or
two of Help, as they did it with Doc2Help. But they're using (say) Flare now, with no previous
experience <snip>

Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days.

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Request of Advice: From: s_borgioli
Re: Request of Advice: From: John Posada
RE: Request of Advice: From: Dan Goldstein
Re: Request of Advice: From: John Posada
Re: Request of Advice: From: Bill Swallow
RE: Request of Advice: From: McLauchlan, Kevin

Previous by Author: Re: Another name for Accordion in Help (developed in Flare)
Next by Author: Re: Creative Writing Assignment - humor
Previous by Thread: Re: Request of Advice
Next by Thread: RE: Request of Advice

What this post helpful? Share it with friends and colleagues:

Sponsored Ads