[TCP] Help Systems
Hello: I have been out of the on-line help world for a number of years now and need some information on the latest tools people are using. We have a number of Windows-based products that need some kind of on-line help solution. We have used RoboHelp for some products and DreamWeaver for others. Our help is translated into 14 languages, including Chinese. Ideally, it would be great to have a single source solution, so we can deliver PDFs as well as help systems. However, we are constrained by a tight budget, so I'm not sure how much we can invest in tools. We currently use FrameMaker 7 and Adobe Acrobat 7.We are looking into delivering the PDF as the on-line help, perhaps using bookmarks to make it more context sensitive. I'd appreciate any ideas on strategies and tools that people have. Regards, Sue Susan S Newton Learning Products Developer __ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com ___ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
Re: [TCP] Help Systems
Hi Susan, I am using Help and Manual as my single source solution. It creates PDF versions of the manuals, as well as html help, browser help, and ebooks. It is very cost efficient and I would recommend that you download a trial version and try it out. Suzette Leeming Stouffville, Ontario On 10/9/07, Susan Newton <[EMAIL PROTECTED]> wrote: > > > > Hello: > I have been out of the on-line help world for a number of years now and > need some information on the latest tools people are using. We have a > number of Windows-based products that need some kind of on-line help > solution. We have used RoboHelp for some products and DreamWeaver for > others. Our help is translated into 14 languages, including Chinese. > > Ideally, it would be great to have a single source solution, so we can > deliver PDFs as well as help systems. However, we are constrained by a > tight budget, so I'm not sure how much we can invest in tools. We > currently use FrameMaker 7 and Adobe Acrobat 7.We are looking into > delivering the PDF as the on-line help, perhaps using bookmarks to make it > more context sensitive. > > I'd appreciate any ideas on strategies and tools that people have. > > > Regards, > Sue > > Susan S Newton > Learning Products Developer > __ > > > -- Please consider the environment before printing this e-mail Need affordable web hosting? I recommend 1 & 1 - that's where I'm hosted! http://www.1and1.com/?k_id=6815038 __ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com ___ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
Re: [TCP] Help Systems
I highly recommend not using a pdf as an online help system. It is not what they are intended for. If you are using FM you can look at WWP to create help from that source. Look at www.help-matrix.com for a list of tools that may meet your reqs. Most tools can import FM source btw. ...Sue On 10/9/07, Susan Newton <[EMAIL PROTECTED]> wrote: > > > Hello: > I have been out of the on-line help world for a number of years now and > need some information on the latest tools people are using. We have a > number of Windows-based products that need some kind of on-line help > solution. We have used RoboHelp for some products and DreamWeaver for > others. Our help is translated into 14 languages, including Chinese. > > Ideally, it would be great to have a single source solution, so we can > deliver PDFs as well as help systems. However, we are constrained by a > tight budget, so I'm not sure how much we can invest in tools. We > currently use FrameMaker 7 and Adobe Acrobat 7.We are looking into > delivering the PDF as the on-line help, perhaps using bookmarks to make it > more context sensitive. > > I'd appreciate any ideas on strategies and tools that people have. > > > Regards, > Sue > > Susan S Newton > Learning Products Developer > __ > > Author Help files and create printed documentation with Doc-To-Help. > New release adds Team Authoring Support, enhanced Web-based help > technology and PDF output. Learn more at www.doctohelp.com/tcp. > > > Interactive 3D Documentation > Parts catalogs, animated instructions, and more. www.i3deverywhere.com > ___ > > Technical Communication Professionals > > Post a message to the list: email [EMAIL PROTECTED] > > Subscribe, unsubscribe, archives, account options, list info: > http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com > Subscribe (email): send a blank message to [EMAIL PROTECTED] > Unsubscribe (email): send a blank message to > [EMAIL PROTECTED] > > Need help? Contact [EMAIL PROTECTED] > > Get the TCP whole experience! http://www.techcommpros.com > __ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com ___ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
Re: [TCP] Help Systems
On 10/9/07, Sue Heim <[EMAIL PROTECTED]> wrote: > I highly recommend not using a pdf as an online help system. It is not > what they are intended for. If you are using FM you can look at WWP to > create help from that source. Look at www.help-matrix.com for a list > of tools that may meet your reqs. Most tools can import FM source btw. Regarding the comment about most tools importing FrameMaker, as of a couple of years ago, only some of the tools were built to handle more than one-time imports of FrameMaker content. I was a beta tester for RoboHelp for FrameMaker, which was built to generate various online help formats from FrameMaker content. It was built to allow you to CONTINUE to use FrameMaker as your composing environment, and would convert your FM source files anew each time you generated your online help. WebWorks Publisher is built the same way. However, other tools (again, as of a couple of years ago) were built to do a one-time import, and updates needed to be made in the online help tool, itself. Forking your documentation source files (print in FM, web-based or online in another tool) is something that should be avoided when possible, and saved for very late in the process when it isn't. -- -David Castro [EMAIL PROTECTED] __ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com ___ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
Re: [TCP] Help Systems
> Regarding the comment about most tools importing FrameMaker, as of a > couple of years ago, only some of the tools were built to handle more > than one-time imports of FrameMaker content. I was a beta tester for > RoboHelp for FrameMaker, which was built to generate various online > help formats from FrameMaker content. It was built to allow you to > CONTINUE to use FrameMaker as your composing environment, and would > convert your FM source files anew each time you generated your online > help. WebWorks Publisher is built the same way. However, other tools > (again, as of a couple of years ago) were built to do a one-time > import, and updates needed to be made in the online help tool, itself. > Forking your documentation source files (print in FM, web-based or > online in another tool) is something that should be avoided when > possible, and saved for very late in the process when it isn't. Currently, WebWorks ePublisher Pro and Flare allow you to reference FrameMaker files in your projects. Once RoboHelp 7 (the TechComm Suite edition) is released, it will allow you to do the same thing. This means that you can point to the Frame files and they will be included when you publish. If you change the Frame files, those changes will be reflected the next time you publish...you don't maintain two copies of the content. Also, I believe that conditions in the WWP/Flare/RH project can be applied in Frame and honored upon publishing. Char James-Tanny ~ JTF Associates, Inc. ~ http://www.helpstuff.com -- Please send follow-up questions to the list. (Inquiries sent off-list may not be seen.) Contact me directly (CharJT at helpstuff dot com) with business inquiries. -- 2006-2007 Microsoft Help MVP Find a Help Authoring Tool at HAT-Matrix.com ~ http://hat-matrix.com Co-author of "Managing Virtual Teams" ~ http://www.wordware.com/wiki AuthorIT Certified Consultant, Development, and Training STC Secretary, 2006-2008 Web site Hosting and Design ~ http://www.jtfhosting.com __ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com ___ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
Re: [TCP] Help Systems
Note that I said IMPORT. I didn't say roundtrip! (And as a "I hate Framemaker" person, I would only ever import the files and then I would throw the source away and work in my new tool of choice! ) I was answering from my Blackberry this morning, so intentionally kept my response short. To the "don't use a PDF as an online help system" statement I made, if you want to question that, take a look at Adobe's own help systems. In the not too distant past, that was how they delivered online help for various apps such as Framemaker and Acrobat. They finally decided to change and provide "real" online help. Which is much more usable and user-friendly. (Technically, you should provide both an online help in whatever format is appropriate as well as a printed manual or PDF. And the two should not necessarily contain the same information.) If you are planning on single-sourcing your content and are going to be translating into several languages, I'd suggest that you take a look at AuthorIT. You can publish into whatever the Windows help format(s) you need, create a PDF, and single-source content. The Localization Manager allows you to easily manage translation jobs, by sending out only the updated content (once the entire thing has been localized). I have a personal preference for AuthorIT, but I also have a personal preference to keep the number of tools I use to create my deliverables down to a bare minimum (one!) and a very strong personal preference to not have to manually manage my translation jobs. But that's just me! ...sue On 10/9/07, David Castro <[EMAIL PROTECTED]> wrote: > > On 10/9/07, Sue Heim <[EMAIL PROTECTED]> wrote: > > I highly recommend not using a pdf as an online help system. It is not > > what they are intended for. If you are using FM you can look at WWP to > > create help from that source. Look at www.help-matrix.com for a list > > of tools that may meet your reqs. Most tools can import FM source btw. > > Regarding the comment about most tools importing FrameMaker, as of a > couple of years ago, only some of the tools were built to handle more > than one-time imports of FrameMaker content. I was a beta tester for > RoboHelp for FrameMaker, which was built to generate various online > help formats from FrameMaker content. It was built to allow you to > CONTINUE to use FrameMaker as your composing environment, and would > convert your FM source files anew each time you generated your online > help. WebWorks Publisher is built the same way. However, other tools > (again, as of a couple of years ago) were built to do a one-time > import, and updates needed to be made in the online help tool, itself. > Forking your documentation source files (print in FM, web-based or > online in another tool) is something that should be avoided when > possible, and saved for very late in the process when it isn't. > > -- > -David Castro > [EMAIL PROTECTED] > > __ > > Author Help files and create printed documentation with Doc-To-Help. > New release adds Team Authoring Support, enhanced Web-based help > technology and PDF output. Learn more at www.doctohelp.com/tcp. > > > Interactive 3D Documentation > Parts catalogs, animated instructions, and more. www.i3deverywhere.com > ___ > > Technical Communication Professionals > > Post a message to the list: email [EMAIL PROTECTED] > > Subscribe, unsubscribe, archives, account options, list info: > http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com > Subscribe (email): send a blank message to [EMAIL PROTECTED] > Unsubscribe (email): send a blank message to > [EMAIL PROTECTED] > > Need help? Contact [EMAIL PROTECTED] > > Get the TCP whole experience! http://www.techcommpros.com > __ Author Help files and create printed documentation with Doc-To-Help. New release adds Team Authoring Support, enhanced Web-based help technology and PDF output. Learn more at www.doctohelp.com/tcp. Interactive 3D Documentation Parts catalogs, animated instructions, and more. www.i3deverywhere.com ___ Technical Communication Professionals Post a message to the list: email [EMAIL PROTECTED] Subscribe, unsubscribe, archives, account options, list info: http://techcommpros.com/mailman/listinfo/tcp_techcommpros.com Subscribe (email): send a blank message to [EMAIL PROTECTED] Unsubscribe (email): send a blank message to [EMAIL PROTECTED] Need help? Contact [EMAIL PROTECTED] Get the TCP whole experience! http://www.techcommpros.com
