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.
If they want changes made to the content, they can email you and you will
incorporate their edits into the content. Put a feedback link at the bottom
of every HTML file that sends feedback directly to you. I had fancy code
that would include the HTML file name the feedback was sent from in the
email. Just make sure you indicate that the documentation feedback email
address is not for reporting bugs or issues with the software.
Think of your help file as software code. Would they be allowed to make
"edits" to the software code? Probably not. Same idea here. Say you have a
standard like using "Go to" as the phrase to begin a sentence that tells the
user navigation, like "Go to Menu1 > Menu2." And they "edit" the text to say
"Access Menu1 > Menu2." Who now has the source files - you or your customer?
Who reconciles your content to your style guide? What if your corporate
style is to follow the MS Manual and they make edits that do not conform
with it? And then, when you get asked to send an updated version of your
help file, all their "edits" get lost because you have the source files and
you do not have their edits. Also, who owns your help file? Your company
does. Check with your legal department about if the client can edit source
In my opinion and based upon what I've been through with different
situations, this is a very slippery slope and it will get bad for you very
All that said, technically, yes, the client can decompile the CHM file, edit
the HTML with Notepad / Dreamweaver, and then recompile. They wouldn't use
MS WinHelp as that is a different help format though.
From: techwr-l-bounces+twer_lists_all=hotmail -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+twer_lists_all=hotmail -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Lynne Wright
Sent: Wednesday, July 31, 2013 9:06 AM
Subject: a RoboHelp/html question
I'm using RoboHelp 7 to convert source content into html and to compile a
.chm file for context-sensitive help.
A customer wants to know if there is a way for them to edit individual .html
files without using RoboHelp.
In theory, could they use Microsoft WinHelp (or some other app) to make
changes and generate new .chm files, or would that cause all kinds of
problems with formatting, hyperlinks, etc ?
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.