Bug 1003752

Summary:	RFE: Ability to compare two revisions for whole books
Product:	[Community] PressGang CCMS	Reporter:	mmurray
Component:	DocBook-builder	Assignee:	Nobody <nobody>
Status:	NEW ---	QA Contact:
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	1.1	CC:	cbredesen
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description mmurray 2013-09-03 06:57:17 UTC

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.

Comment 1 Jared MORGAN 2013-09-09 03:14:09 UTC

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.

Comment 2 Matthew Casperson 2013-11-12 06:15:28 UTC

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.