• Global community
    • Language:
      • Deutsch
      • English
      • Español
      • Français
      • Português
  • 日本語コミュニティ
    Dedicated community for Japanese speakers
  • 한국 커뮤니티
    Dedicated community for Korean speakers
Exit
0

Is Rh the Best App for Managing 41 manuals, with many pages being the same?

New Here ,
Sep 20, 2010 Sep 20, 2010

Copy link to clipboard

Copied

I'd like to automate a labor intensive task that I will soon be assuming. We have 41 install manuals for an automotive accessory that fits 41 different models of vehicles. The current manual is 28 pages with at least 24 pages being identical. The documents are done in Word, along many pictures and drawings. When the document is finished, it is converted to a PDF and sent with the item. The pdf is also made available online for folks who may need the electronic version. When we change one page that is common to all, we have to manually update each Word file and then convert it. As you can imagine, the manuals don't get updated and corrected as often as they should

Since most of the pages are the same, I would like software that can manage changes to these pages and automatically update all manuals. For example, if a change is necessary on page 6 and 34 manuals use this page, I simply change one page and the software "exports" this new page to all affected manuals.

1) Would Rh do this?

2) Would it be the best choice for this task?

3) If Rh is the best choice for this, what is the best approach for beginning this task? Get a book and read or just jump in?

4) I came across a book written by a firm called GooberGuides, is this a good resource? Do you recommend a better one?

5) Does my project require a special technique when setting it up in an app like Rh or is the process fairly intuitive? I don't want to waste time by implementing this incorrectly, only to start over again when I realize there was a better way.

I would be very grateful for any guidance you could provide.

Thank you.

Rodger

Views

626

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
LEGEND ,
Sep 21, 2010 Sep 21, 2010

Copy link to clipboard

Copied

Hi,

1. RoboHelp works best for creating 'online' output. You can create pdf-output, but RH is primarly focused on HTML output. Yes, you can single source your manuals.

2.You may want to take a look at FrameMaker. I think that's better suited for your purposes. You can also check out the Adobe Technical Communication Suite that gives you FrameMaker, RoboHelp, Captivate, Acrobat Pro Extended and PhotoShop. Outside of Adobe, you may find a number of alternatives, such as Scribus (open source).

4. Rick is one of the RoboHelp guru's, so I imagine that his guides have good value for money.

5. Whichever tool you choose, you'll have to think about the way you set it up. Since you're migrating from Word, setting up in FrameMaker of RoboHelp may not seem intuitive at first. After a week or two, you'll never want to move back.

Greet,

Willam

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Expert ,
Sep 21, 2010 Sep 21, 2010

Copy link to clipboard

Copied

I'd second Willam's suggestion of using FrameMaker. Our shop was similar in that we had all our source docs in Word and then PDF'd them & packaged them with the software. We're now in the process of converting/re-writing the docs in FM. We do our primary output to RH's WebHelp and package that now (using TCS2), but we still needed to produce good-looking PDFs for sales team & trainers - that's where FM comes in. FM allows for content reuse that makes maintaining the variations you've got a breeze. With an additional add-on called Framescript, you can "program" repeated actions to really automate your processes. FM is very strong at conditionalizing and variables, so you could have all 41 variants contained within the same book.

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Sep 21, 2010 Sep 21, 2010

Copy link to clipboard

Copied

Thank you very much for the excellent responses! I will take your advice and get started with the product.

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Sep 30, 2010 Sep 30, 2010

Copy link to clipboard

Copied

I don't think your questions were answered, except for the tool one, which is not the most important one. I would reverse your questions:

  1. Does my project require a special technique? Yes! Single sourcing, which is a methodology for developing modular, reusable information, not a tool. Before you even approach a tool, you must analyze your content, define standards for it, define information types (Google for DITA), and convert it from linear (as your Word documents are) to modular.
  2. I have not seen the GooberGuides book, but I can definitely offer these:
    • Content Managment for Dynamic Web Delivery - Jo Ann Hackos
    • DITA 101 - Anne Rockley, Charles Cooper, and Steve Manning
    • Introduction to DITA: A User Guide to the Darwin Information Typing Architecture - Jennifer Linton & Kylene Bruski
    • Managing Enterprise Content: A Unified Content Strategy - Anne Rockley
    • Single Sourcing: Building Modular Documentation- Kurt Ament
  1. Tools - obviously since we're on the Adobe forum, Technical Communication Suite must be acknowledged. But you can accomplish single sourcing with several tools. Check out a brief overview of some at http://www.writersua.com/restools.htm.

Jan Shelton


Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Sep 30, 2010 Sep 30, 2010

Copy link to clipboard

Copied

Thank you Jan!

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
New Here ,
Oct 02, 2010 Oct 02, 2010

Copy link to clipboard

Copied

LATEST

You're welcome. Good luck.

Jan

Votes

Translate

Translate

Report

Report
Community guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Resources
RoboHelp Documentation
Download Adobe RoboHelp