Help to FM suggestions

Subject: Help to FM suggestions
From: Damien Braniff <Damien -dot- Braniff -at- asg -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Apr 2012 10:00:39 +0100

Currently working on product where the only existing documentation is the Help and we're looking to single-source from FM. General procedure we have is OK:
Help (RH) > printed doc (Word) > FM
Fairly straightforward process (once styles are standardized) but have you any suggestions for how best to get the structure you want in FM?
Help topics > FM sections but as we all know Help isn't linear so while there is a 'flow' there's also assorted branches... Any suggestions as to how best to sort it out? I've done one small Help so far which was easy to work out but the next is going to be fun (Printed doc 600+ pages). I think I can break it down into what will be FM Chapters which helps but after that...
I've thought of doing a 'map' to show the flow with links shown as branches to the main flow... any thoughts /suggestions welcome.
Damien Braniff
Sr. Technical Writer
damienb -at- asg -dot- com<mailto:damienb -at- asg -dot- com>
Waterfront PLaza
8, Lagan Bank Road
Belfast, N. Ireland
Tel: +44 0 28.9072.3124
Fax: +44 0 28.9072.3324<>
ASG-CloudFactory - The Single Solution to Build, Deploy & Manage your Cloud Environments
Click here for more information on the ASG-CloudFactory<>

Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.


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 @


Previous by Author: RE: SharePoint for Review Copies
Next by Author: RE: Post on Technical Writing vs. Technical Communication
Previous by Thread: Re: The Whatchamacallit
Next by Thread: RE: Help to FM suggestions

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

Sponsored Ads