Skip to main content
alexjfox
Participant
May 6, 2026
Question

RoboHelp and Adobe are untenable for technical documentation

  • May 6, 2026
  • 2 replies
  • 8 views

I have tried and tried with RoboHelp. I moved to it after 10 years of MadCap Flare use looking for something new that was more actively maintained, I thought RoboHelp was the answer, but no.

The app is brittle and full of bugs. The logic behind dynamic content filtering is completely broken and the Frameless output does not work with custom JavaScript, even if I include it as an asset in the skin because the order in which the content is loaded means the JS is looking for elements that don’t exist. I cannot get around this despite trying different approaches for months. Occasionally the “insert paragraph here” blue line gets rendered in actual output because RoboHelp edits the page source to render it in real time (wtf?).

I have raised many bugs that have not been acknowledged.

The “official” help is woeful and everyone just gets sent to Peter’s site - which is good - but shouldn’t be the official RoboHelp resource.

I managed to put together some really useful scripts with the help of Claude analysing the app files, but this got my community account banned immediately and two support chats have not been able to resolve it. I was not given any warnings about this first, just an immediate ban.

On a wider note, the Adobe site experience is pretty awful too, constantly getting bounced around/redirected/logged out/forced to the UK site etc.

Anyway, that’s just my rant. I’d love to be able to use RoboHelp but I just can’t justify trying to work around the bugs or compromising on the utility that I want. I’m probably going to move to pure markdown in something like mkdocs.

 

    2 replies

    Jeff_Coatsworth
    Community Expert
    Community Expert
    May 6, 2026

    I think Peter’s put it fairly well, but I would add that RH is primarily a help authoring tool (HAT) and may not fit with many docs-as-code workflows that markdown supports. But that’s ok - different tools for different workflows.

    Peter Grainge
    Community Expert
    Community Expert
    May 6, 2026

    The logic behind dynamic content filtering is completely broken

    No, not completely broken. I worked with someone recently and we found why it wasn’t working the way that was expected. By changing the tagging, it worked. 

    If you explain why you say it is broken, maybe then someone can help.

    Javascript

    Can’t help you on that.

    Occasionally the “insert paragraph here” blue line gets rendered in actual output

    I’ve heard that but I thought it had been fixed way back. What version are you on?

    The “official” help is woeful 

    Much of what is on my site is also in the About RoboHelp sample project that is supplied. 

    Your scripts

    Were these put on the RoboHelp forum and, if so, when? I don’t recall seeing them and don’t follow why they would be banned unless there was something someone considered dangerous. Were you offering them free or for a charge? 

    ****************************************

    Basically a rant like this isn’t going to help. Create some specific posts setting out the problem and the version being used and maybe then someone can help.


    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.