[LUDOC-13] reviewing changes is difficult in docbook xml

• Type: Improvement
• Resolution: Unresolved
• Priority: Minor
• Labels: QInfrastructure
• Business Value: 25
• Assignee: Lustre Manual Triage
• Reporter: Richard Henwood (Inactive)

Description

I suggest that the Makefile be enhanced with a 'make htmldiff'.

I have had some success with:

1. Build a manual.html (xhtml-1_1) from MASTER:

   xsltproc --stringparam  fop1.extensions  1 --stringparam  section.label.includes.component.label 1 --stringparam  section.autolabel 1 --stringparam  chapter.autolabel 1 --stringparam  appendix.autolabel 1 --xinclude -o /tmp/newmanual.html /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/xhtml-1_1/docbook.xsl ./index.xml
   

2. Build a newmanual.html (xhtml-1_1) from REVIEW.
3. Create a diff.html with diff annotation using diff.py
4. Point browser at diff.html.

Issue Links

• Trackbacks: Guidance for Manual reviewers The Lustre manual is written in XML and changes can be made using Gerrit workflow typical for code. However some additional tips are necessary to ensure high quality reviews. Always visit the HTML or PDF version of the document....
• Trackbacks: Guidance for Manual reviewers The Lustre manual is written in XML and changes can be made using Gerrit workflow typical for code. However some additional tips are necessary to ensure high quality reviews. Always visit the HTML or PDF version of the document....