RE: Help to FM suggestions

Subject: RE: Help to FM suggestions
From: "Porrello, Leonard" <lporrello -at- illumina -dot- com>
To: Damien Braniff <Damien -dot- Braniff -at- asg -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Apr 2012 14:20:48 +0000

With at least three excellent HATs on the market that are designed to single source, two of which cost no more than Frame and import RH, chm, and html files directly, how did you arrive at the conclusion to single-source using Frame? I am not saying that is necessarily a bad decision, and I am very curious about the requirements.

-----Original Message-----
From: techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lporrello=illumina -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Damien Braniff
Sent: Friday, April 20, 2012 2:01 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Help to FM suggestions

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
BT1 3LR
Tel: +44 0 28.9072.3124
Fax: +44 0 28.9072.3324
www.asg.com<http://www.asg.com>
ASG-CloudFactory - The Single Solution to Build, Deploy & Manage your Cloud Environments Click here for more information on the ASG-CloudFactory<http://www.asg.com/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.

http://bit.ly/doc-to-help

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

You are currently subscribed to TECHWR-L as lporrello -at- illumina -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

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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.

http://bit.ly/doc-to-help

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

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


References:
Help to FM suggestions: From: Damien Braniff

Previous by Author: RE: glüten gleebin glautin glöbin
Next by Author: RE: Help with a term
Previous by Thread: Help to FM suggestions
Next by Thread: Title case in documentation


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

Sponsored Ads


Sponsored Ads