Skip to main content
J
jrothlander
Participant
June 29, 2011
Question

New to RoboHelp... can it do this?

  • June 29, 2011
  • 1 reply
  • 1125 views

I am new to RoboHelp.  Actually, I have never used it.  But I need to know if it can handle what I need to do before I invest in it and spend a lot of time trying to figure it out.  I have read through a lot of introductions, tutorials, product overviews, etc. and they all talk about a lot of features that are really nice.  But what I need is VERY simple.  So it seems to be skipped by all of the tutorials, articles, etc.  So I want to find out if RoboHelp can do what I need, which I assume it can because my needs are simple.  But I also want to get some ideas on how best to approach this.

I have a VERY large application with a custom help system.  I want to convert this to RoboHelp.  By large I mean many applications, many millions of lines of text stored is nearly 10,000 individual help screens.  I assume this is large, but maybe it is not compard to the average these days.

Here's the problem.  If I manually enter the information it will take an estimated 24+ months for a team of 25 to 35 contractors or more at a cost of around $5M just to get the help moved over.  That is not within the budget.  However, I can covert the help screens however I wish.  I can convert them to HTML, CSV, TXT, or whatever else I need to.  But there are tags in them for context-sensitive help.  So when a user clicks help on a screen, the help pops up and positions to that page in the help application.  But that about all there is to it.  The help is very simple, no graphics, no styles or anything.  Just .TXT files and context-sensitive tags.  I know RoboHelp can support those.  But can I create some tagged marked-up version of the current files and use those to load into RoboHelp.

The idea is that if we bring this into RoboHelp we will have a solid base to build on going forward and we can add graphics and more advanced feature as time goes forward.  But the old version is what we have today and we need to get it into RoboHelp and converting the pages one at a time is not an option.  We have to do some work to run a program and convert them to what RoboHelp can import and I REALLY need the context tags to be loaded automatically by RoboHelp if possible.  I cannot spend 12-months going in and adding the tags for the context sensitive help.

Now I know that RoboHelp can import many types of files. So my thought is to find the simplest format that has the context-sensitive tag and run a conversion process to create simple text files and generate whatever RoboHelp needs to import.  But what I do not know is what format that is, if I can get the context-sensitive tags to load into RoboHelp.

If RoboHelp supports this out of the box, that would be great.  But I suspect that I would have to run a conversion process to create a format that RoboHelp can import.  Which is no problem at all.  As long as the format is able to be written out in simple text files, I can do it.  But what format and how do get the context-sensitive help to work/load into RoboHelp?

So any suggestions or thoughts would be much apprecaited.  If you have link with a sample or tutorial, that would be perfect.

Best regards,

Jon

    This topic has been closed for replies.

    1 reply

    Peter Grainge
    Community Expert
    Peter GraingeCommunity Expert
    Community Expert
    June 29, 2011

    Picking on key points...

    PROJECT SIZE

    Assuming the 10,000 individual help screens you refer to are going to translate to 10,000 topics (HTML files) then that is large and above the size I would recommend for an individual RoboHelp project. I would be setting up Merged Help which means you would have several projects but the end user would view them as if they were one. Merged help is described on my site

    You have not said what help output you will be creating and that pretty much depends on where it will reside.

    • If local you could use WebHelp but the Chrome browser is beginning to prevent that being an option as it will not display locally installed webhelp. See Snippets on my site for an explanation. The alternatives are CHMs or AIR help. Both can be merged.
    • If on a server, then you need WebHelp or FlashHelp. The former is more robust.

    CONVERTING TO ROBOHELP

    I am struggling to see where you get your $5M estimate and the need for 24+ months and a team of 25 to 35 contractors. Lets say the workflow is copy/paste the content from one of your screens into a RoboHelp topic and then format it. Say 15 minutes per topic that gives 2500 hours or just over 100 days for one person. The other contractors would be having a wild party so perhaps that's where the cost is going.

    Being serious there must be more to the task than you are telling us and maybe that is important to the reply.

    IMPORTING HTML

    If you can convert the existing content into HTML files that RoboHelp can digest via the Import function, you can import all the files in one folder. That's the theory and I would suggest you do so in batches closing RoboHelp every so often. In Tools > Options tick the option to always clear the cache (the CPD file).

    CONTEXT SENSITIVE HELP

    You are referring to tags. Do you mean bookmarks? Does your application call topics or specific locations in topics?

    RoboHelp can support calls to topics or bookmarks within them. There is information on my site about calling help.

    CONSULTANCY


    I wonder if for a project of this size you are going to need some external consultancy? It is not something I offer as I am a full time employee but I may be able to suggest people depending on where you are based.

    See www.grainge.org for RoboHelp and Authoring tips

    @petergrainge

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
    J
    jrothlanderAuthor
    Participant
    June 29, 2011

    Peter,

    Thanks for the reply.  You asked a few questions that I wanted to respond to, to make sure I am on the right page and representing what I am doing correctly.

    Jon

    Here's the basic idea of what we have.  We are looking at millions of lines of code that make up the text of the help system, about 5K individual files.  I said 10K earlier but that is wrong.  But each of those 5K in files does not translate to one help topic, but to many.  The ones I looked at had about 25 to 50 help topics in each file and it looks like this one is a small one.  When you do the math you come up with much more than 10K in help topics, closer to 80K individual help topics.

    Now this help system is for a VERY large system.  The system is divided into logical subsystems.  If this was an accounting program like QuickBooks, it would have modules for HR, AR, GL, etc.  Now the help handles all of those.  But when we convert the help to RoboHelp, each of those will be a different help.  So what we have now doesn't match with what we will have.  We are basically redesigning the structure of the help system.  

    So what this means is that a contractor would have to cut in paste about 80,000 individual enteries from 5,000 text based source files into RoboHelp.  Then from there, adjust those with headings, bookmarks (tags?), or whatever else they need, and then remove all of formating lefover from the old system.  There's a lot of special characters and markup tags in the old system.  So those would have be removed.  Then they would do whatever you need to do for the content page, indexing, merging, and other things.

    You estimate it would take someone about 15-minutes to do that per help topic.  So if you do the math that is 20,000 hours.  Or roughly 20 full time contractors for a little more than a year, which would run about $2M if we get a good rate.  Or if you did in in-house team you might get away with a little less than $1M.  That is a lot less than $5M, but it is still a considerably large investment.

    For about $30K I can just build my own webForm winForm viewer, which was my original plan.  But I am a contractor and when this project is over other people will have to maintain it.  Other people that are not software developers.  So any adjustments in the future would be hard.  I could convert everything over to HTML pretty easily.  That may make it a little easier because they'd just be doing HTML after I leave.  However, I was thinking that if we went with a industry leader like RoboHelp, in the future they'd be able to do pretty much anything we wanted to do. But the difference between $30K and $1M or more is pretty significant.  They will not give me $1M to do it.  They would simply leave it as is or they would ask me to write a custom viewer.  But I think RoboHelp is the right way to go.  I just have to do something to convert and important the files because a manual process is really not an option.

    So my next idea is to take the help and convert to HTML, XML, or whatever we need to do to let RoboHelp import this.  Then do a mass important.  We already have the 80K topics organized in 5K files, so we'd just need to organize those into logical groups to create say 100 to 500 individual help files.  Then do a mass conversion into HTML or XML or something else.  Then do a mass important to RoboHelp.

    What I have to do is to figure out if it will work, how long it will take, and what the end result will look like.  Adding consultants might be an option, but only if we can do the mass imports.  The consultants would come into play after the mass important to clean up, test, etc.  We would not be able to hire consultants to cut-n-paste in a manual approach.  It would be too costly compared to other options that we have.

    Jeff_Coatsworth
    Community Expert
    Jeff_CoatsworthCommunity Expert
    Community Expert
    June 29, 2011

    Cheapest thing I would suggest is downloading the free trial of RH9 and start playing around.

    Terms & ConditionsAccessibility statement
    Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices