TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: Question for Flare Users From:Rick Stone <rstone75 -at- kc -dot- rr -dot- com> To:laura_johnson -at- agilent -dot- com Date:Sat, 25 Apr 2009 22:49:54 -0500
Hi Laura
From what you have posted it would seem you are holding and are putting
forth some false or mistaken impressions.
* Some annoying defects in RoboHelp were fixed in Flare; the ones that come to mind (this is based on my experience with RoboHelp X5) are poor PDF output, some bugs with merging multiple help projects, and lack of command-line build capability (so it's hard to integrate your help into an automated build process). Flare provides a nicer authoring environment and more consistent results (once you're used to it) because of its use of structured editing and emphasis on stylesheets; the XHTML source it produces is less noisy (hence more portable) than RoboHelp's HTML. More importantly, RoboHelp is an aged product with a very large code base and an R&D team that have no history with the product; Adobe's commitment to the product is real, but seems weak. Flare is more robust because of its managed-code code base and is staffed with experienced (and enthusiastic!) developers; Madcap was founded for the purpose of creating help-authoring tools and Flare is its flagship product. Flare is at 3.0 now and is very stable. It does a very good job of importing RoboHelp projects and templates.
I'm sure it's difficult to keep up with odd version naming or numbering,
but RoboHelp lives on beyond X5. Your response would seem to imply that
RoboHelp X5 simply evolved into Flare. I suppose on some level that is
plausible, but Flare and RoboHelp are two entirely different products.
RoboHelp is quite alive and well. Since X5, Adobe introduced version 6,
then version 7 and most recently version 8. Sure, maybe initially the
Adobe team had little initial experience with the X5 code base, but
RoboHelp has evolved into a different product. I would think after three
releases they are surely comfortable with the code base.
* For intents and purposes, I was a first time user with no (within the last 10 years) Robohelp experience. I found it very easy to learn and use Flare.
I find it odd that you are citing no recent experience, yet you claimed in your first bullet point that what you were stating was "based on my experience with RoboHelp X5". You are citing that some annoying defects in RoboHelp being fixed in Flare. If you didn't use RoboHelp in 10 years, how would you even know about any defects? How do you know Flare is "more robust because of the managed code base"? You can't really compare Flare version 3 with RoboHelp X5. If you are going to make comparisons, it would only be fair to compare the latest Flare version to the latest RoboHelp version. ;) I mean no disrespect here, but this sounds like you are simply reciting Flare market speak. ;)
"...You feel sort of dyslexic using the structured editor at first; you don't always know what you're looking at, and basic things like text selection don't do quite what you expect."
Ouch! I hate when that happens! ;)
"We stopped complaining after a week or two of steady use."
Does this mean that you just became used to not knowing what you were looking at and you simply accepted that basic things didn't do what was expected? ;)
"...if you can't find a feature, you can search their help using the RoboHelp terminology and easily find the Flare equivalent."
I'm not sure about anyone else, but I'm curious to know why familiar terms are inexplicably replaced with unfamiliar terms? If something has always been called a flimjam, why suddenly begin calling it a hoojab?
Cheers... Rick :)
laura_johnson -at- agilent -dot- com wrote:
> I get this question from time to time. Here's my most recent response, dusted off and updated:
>
> A few of us in my organization have been using Flare for awhile now. We're quite happy with it. We began using version 1.1 in May 2006 and have used it for three good-sized software projects, one of which has shipped to external customers and one of which is about to ship (both of these used compiled HTML help). The third project is internal-only; you can see our Flare-generated web help for that product at [deleted cause it's internal]. (We also generate .chm files that get installed with the software, but the web help is nice for an internal product; we can update it more often that way.)
>
> We recorded some observations for another team that has since adopted Flare:
> * Some annoying defects in RoboHelp were fixed in Flare; the ones that come to mind (this is based on my experience with RoboHelp X5) are poor PDF output, some bugs with merging multiple help projects, and lack of command-line build capability (so it's hard to integrate your help into an automated build process). Flare provides a nicer authoring environment and more consistent results (once you're used to it) because of its use of structured editing and emphasis on stylesheets; the XHTML source it produces is less noisy (hence more portable) than RoboHelp's HTML. More importantly, RoboHelp is an aged product with a very large code base and an R&D team that have no history with the product; Adobe's commitment to the product is real, but seems weak. Flare is more robust because of its managed-code code base and is staffed with experienced (and enthusiastic!) developers; Madcap was founded for the purpose of creating help-authoring tools and Flare is its flagship product. Flare
> is at 3.0 now and is very stable. It does a very good job of importing RoboHelp projects and templates.
> * Excellent Support. Both through the help community and when I've escalated issues with a support ticket; I've always received reasonably timely assistance.
> * Regular new versions with innovative features. This includes, for example, the Feedback Service, Topic Tracking, import/export to FrameMaker, etc. Even though I haven't used these features (yet), I am impressed that Madcap has developed them.
> * For intents and purposes, I was a first time user with no (within the last 10 years) Robohelp experience. I found it very easy to learn and use Flare.
> * Some things were not as I expected, such as importing XML code samples into a topic, and some things are a little quirky, such as the red/yellow control boxes and cursor size significance, but again, overall I found it very easy to learn and use.
> * It is stable (no crashes), importing existing RoboHelp files was very easy, search capabilities are great, it has a rich feature set, etc.
> * Command line build is very easy (though it doesn't report all errors).
>
> If you're buying, it's worth paying for bronze-level support: you get free upgrades that way, and they're upgrading rapidly (went from version 1.0 to 3.0 in 15 months).
>
> We didn't really take a quantifiable schedule hit learning Flare. You feel sort of dyslexic using the structured editor at first; you don't always know what you're looking at, and basic things like text selection don't do quite what you expect. We stopped complaining after a week or two of steady use. Everything else is quite natural, and if you can't find a feature, you can search their help using the RoboHelp terminology and easily find the Flare equivalent. We've brought in contractors who had experience with other HATs but not with Flare; they've had no trouble picking up Flare quickly.
>
> If you haven't browsed the user forums at www.madcapsoftware.com, take a look: there are lots of real people using Flare and talking about it. The Madcap folks I've contacted via support, the forums, and at WritersUA in 2007 really seem to speak our language and understand our needs.
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
> solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
> HTML and publish to the Web, Help systems or printed manuals.
>http://www.doctohelp.com
>
> Help & Manual 5: The complete help authoring tool for individual
> authors and teams. Professional power, intuitive interface. Write
> once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as rstone75 -at- kc -dot- rr -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit http://lists.techwr-l.com/mailman/options/techwr-l/rstone75%40kc.rr.com
>
>
> 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
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-