Re: HTML 5 web help versioning

Subject: Re: HTML 5 web help versioning
From: Robert Lauriston <robert -at- lauriston -dot- com>
To: Hannah Drake <hannah -at- formulatrix -dot- com>, TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 19 Nov 2014 09:23:56 -0800

Which authoring tool are you using?

Standard practice is to put the product and version in the URL, so
each release of the product has a unique base URL for the help. For
example:

http://help.adobe.com/en_US/FrameMaker/11.0/Using/WSd817046a44e105e21e63e3d11ab7f7561e-7fff.html

http://help.adobe.com/en_US/FrameMaker/10.0/Using/WSd817046a44e105e21e63e3d11ab7f7561e-7fff.html

Typically on the web site the latest release has no version, so a URL
without a version gets you the latest and greatest:

http://help.adobe.com/en_US/framemaker/using/WSd817046a44e105e21e63e3d11ab7f7561e-7fff.html

What tool Adobe uses to generate the pop-up version menu in the bottom
corner I don't know but that's external to the help. Maybe
Dreamweaver, Flex, or Cold Fusion.

MadCap used to do much the same thing but they seem to have removed
the older versions from their site.

http://webhelp.madcapsoftware.com/flare10/Default.htm#Output/Determining_the_Output_Type.htm

On Wed, Nov 19, 2014 at 8:13 AM, Hannah Drake <hannah -at- formulatrix -dot- com> wrote:
> Hi all,
>
> Hope you're having a wonderful Wednesday. I'm wondering what you do for
> products that have online help and different software versions. We are
> thinking we need versions, as in website.com/3.1, and so on, but I don't
> think I've ever seen a release in a URL? How is this done at other
> companies?
>
> The concern is that the users with older products will go find online help
> and it will be unhelpful since it's not related to their version, if we
> only put the latest up.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
HTML 5 web help versioning: From: Hannah Drake

Previous by Author: Re: "Technical Writing: A Viable Career (Or Sideline) Option for Writers"
Next by Author: Re: HTML 5 web help versioning
Previous by Thread: HTML 5 web help versioning
Next by Thread: Re: HTML 5 web help versioning


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


Sponsored Ads