: Re: Technical review process when using FrameMaker I'm an engineer. At my company, engineers seem to spend a lot of time reviewing technical documentation written by people who work in different

@Sims2267584

Vote Up Vote Down

Using code review tools on FM XML has a few drawbacks:

You run the risk that programmers will want to change the XML code, rather than just the text. You'd have to use tooling to make the XML structure read-only and allow changes to the text elements only.
The text becomes less readable due to the inline tags for xrefs, text insets, character styles etc.

PDF avoids all this, and has some additional advantages:

It prevents the reviewers from changing the source text. Engineers aren't writers, as a writer I want final authority over the text in my document.
if you use PDF, you can use the change tracking mechanism in FrameMaker to mark the new text, allowing the reviewer to concentrate on that instead of having to read the entire document.
PDF allows you to have multiple reviewers check a document simultaneously, and you can collect the comments afterward. Or they can review sequentially and react to the comments made by earlier reviewers.
PDF comments allow the reviewer to indicate why a change needs to be made. This gives the writer a better insight into what he's writing about.

(0)

Login to post a comment!