Possible to review two conditions in a single doc?
Posted: Tue Dec 17, 2013 3:02 am
CONTEXT:
I'm a newbie, greatly enjoying oXygen and the productivity it gives for bringing DITA into our organisation (but an old hand at doco in general).
Our help is generated as HTML files deployed in two distinct sets, depending on whether the product in installed on premises or as SaaS. This means many topics have <ph> (and other) tags distinguished by "product" attributes, up the the level of some entire topics being for one product or the other, just as you expect.
Our engineers have (surprise!) limited time and attention for doco reviews. I generally publish a PDF from an entire map -- the help subset that impacts each engineer or group -- and they provide markup within the PDF. However, there is no way I can wring from them enough time to do reviews of TWO distinct PDFs.
THE QUESTION:
Is there a way to publish a 'review PDF' such that, if I leave both conditions on and the PDF contains both sets of text, they can be demarcated from one another in the PDF so that reviewers can easily see the distinctions between help versions and review them both efficiently? I have in mind something like the demarcation that displays in the Author view as I work on the documents.
I imagine I could learn a whole lot more and do something to customise output styles for the 'review PDF' output type; but I was rather hoping for something built-in to the product that I might have missed and could just 'turn on' in the zero minutes I have for this refinement.
I'm a newbie, greatly enjoying oXygen and the productivity it gives for bringing DITA into our organisation (but an old hand at doco in general).
Our help is generated as HTML files deployed in two distinct sets, depending on whether the product in installed on premises or as SaaS. This means many topics have <ph> (and other) tags distinguished by "product" attributes, up the the level of some entire topics being for one product or the other, just as you expect.
Our engineers have (surprise!) limited time and attention for doco reviews. I generally publish a PDF from an entire map -- the help subset that impacts each engineer or group -- and they provide markup within the PDF. However, there is no way I can wring from them enough time to do reviews of TWO distinct PDFs.
THE QUESTION:
Is there a way to publish a 'review PDF' such that, if I leave both conditions on and the PDF contains both sets of text, they can be demarcated from one another in the PDF so that reviewers can easily see the distinctions between help versions and review them both efficiently? I have in mind something like the demarcation that displays in the Author view as I work on the documents.
I imagine I could learn a whole lot more and do something to customise output styles for the 'review PDF' output type; but I was rather hoping for something built-in to the product that I might have missed and could just 'turn on' in the zero minutes I have for this refinement.