Red Hat Bugzilla – Bug 1003752
RFE: Ability to compare two revisions for whole books
Last modified: 2014-08-04 18:29:20 EDT
Description of problem:
QE want things that have changed in books to be highlighted in some way (so they don't have to reread everything, only the things that have changed).
Some people are using remark tags for this. But that requires removing the remark tags at a later date.
I think it would be useful if in docbuilder there was a way to use some kind of diff process to highlight all of the changes in a book between two revision numbers. Then this link could be given to QE.
This would be an excellent enhancement, and would probably win the votes of many docs QE folks who are after this type of granularity with review targets.
I'm not sure we could implement this efficiently in DocBuilder. It would mean maintaining diffs indefinitely, or providing some UI to request diffs be built.
https://code.google.com/p/daisydiff/ is an open source library that produces reasonable output when used on HTML single Publican builds. This could be built into csprocessor, or we could just write up instructions on how to use it manually.