Our documentation is stored in XML and to provide a proper review you need to see the raw XML, for metadata that is not in the rendered view, as well as looking at how the content actually renders in plain text (or html or pdf) - it really is just text there are no images in this documentation since they are UNIX style man pages.
We have a command that can convert the XML into plain text, which I could then use to provide a before/after diff of the rendered page (providing full context using ‘diff -U99999’).
What I would like to do is have the diffs for a given review be both the diffs of the XML - which are what we will actually push via mercurial (we don’t use arc land at all) - and the diffs of the rendered plain text (which are never pushed anywhere and aren’t committed in the mercurial workspace).
I can do that using the ‘arc diff --raw-command’ to supply a diff of the XML and the plaintext; but then I loose the metadata/context about the repo/branch and the source repositories hostname and path. We need the repo/branch metadata for our automated builds, because there are usually C/Python source code changes that go along with the documentation changes.
Generating the rendered documentation view “server side” via a Herald hook would be acceptable but I don’t believe I can make it part of the same set of diffs that way.
Currently our developers use ‘arc diff’ directly without any wrapper, but if we need to provide a wrapper script that would be acceptable. I don’t want the developer do have to run multiple steps, to get the rendered view submitted along with the raw XML.
Any ideas on how to achieve this ?