RE: TECHWR-L Digest, Vol 81, Issue 19

Subject: RE: TECHWR-L Digest, Vol 81, Issue 19
From: MaryElise Dedicke <maryelise -dot- dedicke -at- pb -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Jul 2012 12:15:05 +0000

I also create online help for cloud apps. The banking app I'm working on now has 4 roles currently & will have more in the future. I use the DITA OT to create XHTML help, so I leverage the audience attribute at the ditamap level for topics that exclusively belong to just one or two roles, or at the paragraph level within topics when it's the case that all roles have access to a page in the app but see different content. I also created separate build scripts and ditavals for each role, so I can produce separate output for each role. One of the writers here created a javascript file which I populate with a case for each topic path, then I pass it to a developer who hooks each case in the js file to the appropriate page in the app. I have the help files hosted on our own docs server so I can update it at will. This is the 2nd project using this process and it's working well so far!

Mary Elise Dedicke, Advisory Technical Writer
Pitney Bowes Software
One Global View | Troy, NY 12180 USA
Office: 518.285.7646 | Fax: 518.285.7420 |
MaryElise -dot- Dedicke -at- pb -dot- com

Every connection is a new opportunity(tm)

-----Original Message-----
On Thu, Jul 19, 2012 at 9:17 AM, John G <john -at- garisons -dot- com> wrote:
> Fellow Whirlrs,
> Our cloud-based suite of applications is merging into a single interface
> that will allow users to free themselves from multiple stand-alone
> applications and to begin to use the features available from all the apps
> based on the roles and permissions they have. Great concept, but the
> challenge for us to document this is how we manage the online help so that
> wherever a user is they get the help for wherever it is that they are.

> We use Adobe TechComm Suite 3.5 (FM10 and RH9) and are looking into the
> features they provide - conditional text, text insets - but wonder what
> someone who has done something similar might have to say about the approach
> they took and a retrospective look at their experience.

> Anyone done anything like this who would like to share a war story or three?


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: Careers For People Who Don't Like People
Next by Author: Re: Technical Writing vs. Professional Writing
Previous by Thread: Re: Arabic text in multilingual manual
Next by Thread: Techwhirl Technical Communication Recap for July 20, 2012

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

Sponsored Ads