Re: alias files (was Re: Hosted Help - server specs?)

Subject: Re: alias files (was Re: Hosted Help - server specs?)
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: Kathleen Johnson <Kathleen -dot- Johnson -at- visionsolutions -dot- com>, Technical Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 5 Dec 2013 09:47:51 -0800

Hard-coded web help URLs are specific to each authoring tool. If you
ever want to switch from, say, Flare to DocBook WebHelp, you'd need to
edit every individual help call. It took me several weeks to migrate
from RoboHelp to WebWorks since I had to edit hundreds of calls in the
application source code. If we'd been using an alias file, it would
have taken only a few hours.

Similarly, using an alias file lets you reorganize the help (split a
topic in two, fold one topic into another, etc.) without having to
touch the application source code. This is particularly helpful when
the developers won't let you edit the application source and you're
dependent on them to fix things.

On Thu, Dec 5, 2013 at 5:41 AM, Kathleen Johnson
<Kathleen -dot- Johnson -at- visionsolutions -dot- com> wrote:
> "I strongly recommend using alias files rather than letting developers hard-code calls to specific pages."
> Why? We just had a discussion on this yesterday. Alias files seems so cryptic and high maintenance. If you have a standard naming convention between the application and the help files, it seems easier and lower maintenance to just call a specific page.

New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more:


You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @

alias files (was Re: Hosted Help - server specs?): From: Kathleen Johnson

Previous by Author: Re: Hosted Help - server specs?
Next by Author: Re: Hosted Help - server specs?
Previous by Thread: RE: alias files (was Re: Hosted Help - server specs?)
Next by Thread: RE: Security Audits (RE: Two million passwords stolen and posted online)

What this post helpful? Share it with friends and colleagues:

Sponsored Ads