RE: most effective method for SME review?

Subject: RE: most effective method for SME review?
From: "David Artman" <david -at- davidartman -dot- com>
To: "Tom Johnson" <tomjohnson1492 -at- gmail -dot- com>, "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 22 Oct 2015 12:45:31 -0700

At my firm, we have a mix of attentive SMEs: Some review same day as
asked; some have never reviewed without my calling a meeting of the
team and reading the document to them.

So far, my most-effective approach is as follows (both FrameMaker and
DITA, with minor tweaks to process):

* FM: Put Index markers with info about what is changed on each change.
[We do not make Indexes yet; if we did, I'd use a different marker

DITA: Put processing-instruction elements at all change locations and
use a custom transform to generate a change log out of them, across a
specified date range (i.e., each development-draft iteration, as
tracked using critdate elements).

* Apply New (blue-text) or Deleted (FM: red-strikeout-text; DITA:
red-background-text) conditions (or rev attributes triggered by a
ditaval file) to highlight the changes at those locations.

* Generate a List of Markers (or the aforementioned change log) at the
front of the development draft, with hyperlinks to each marker (or

* Send to Adobe Shared Review to track comments.

* Integrate changes in next draft; comment out previous draft's Deleted
markup; and repeat.

I usually have to prod SMEs after a week or so to get on with it. I'm
authorized to employ The Meeting ThreatA(R) to encourage folks to
review promptly ("No one has clicked into the review, so I'm scheduling
a team review meeting for three hours. If, of course, folks review
before the meeting, it will take far less time because we'll only have
to address unclear comments and markup."). It has about a 50% efficacy
at prompting folks to Just Do It. Of course, folks who like to burn up
their hours in meetings love them. Can't win 'em all....

Hope this helps;


-------- Original Message --------
Subject: most effective method for SME review?
From: Tom Johnson <[1]tomjohnson1492 -at- gmail -dot- com>
Date: Wed, October 21, 2015 8:12 pm
To: TECHWR-L <[2]techwr-l -at- lists -dot- techwr-l -dot- com>
What has been your most effective method for reviewing docs with
matter experts? I feel like I've tried everything and haven't really
upon the best way of doing it.


1. mailto:tomjohnson1492 -at- gmail -dot- com
2. mailto:techwr-l -at- lists -dot- techwr-l -dot- com
Visit TechWhirl for the latest on content technology, content strategy and content development |


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: PPT training materials, pdf output (with inter pdf/ppt project hyperlinks) --what is the best tool?
Next by Author: RE: most effective method for SME review?
Previous by Thread: Re: Design templates
Next by Thread: Re: most effective method for SME review?

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

Sponsored Ads