RE: [docbook] document reviewing ideas

[Norma E Emery <nemery@student.hagerstowncc.edu>]

Mats,

Re:
"Yes, I am trying to avoid the excuse of reviewing being too cumbersome:"

Thanks, understood! I don't know of any approach that would meet both needs -- give the reviewer a wysiwyg environment and let you easily drop in their feedback -- especially since you can't swing more oXygen licenses.  If wysiwig were not a factor, you could ask them to add comments into copies of your XML objects using Textpad, then you could run a compare to see the changes and "accept" (copy) changes into the original XML.

Since you moved to Docbook to reuse common content, maybe your reviewers would be willing to try this especially if they knew they could avoid reviewing the common content within all of the documents.

The best luck I'm having lately with reviews is when I print out affected pages, highlight the new text, and take the page to the reviewer's office. 

Good luck. I will be interested to hear if you have any success with the git repo approach.

Regards,
Norma Emery
________________________________________
From: maxwell <maxwell@umiacs.umd.edu>
Sent: Thursday, January 2, 2014 5:56 PM
To: docbook@lists.oasis-open.org
Subject: Re: [docbook] document reviewing ideas

On 2014-01-02 17:41, Mats Wichmann wrote:
> Yes, I am trying to avoid the excuse of reviewing being too cumbersome:
> Oh, I have to write up "In section 5.2, Foo, second paragraph, change
> Bar's to Bar is", I can't just click and fix it in the doc? But really,
> I'm fishing for Best Practices, other people must have reviewing issues
> as well.  I've worked on other projects where we kind of dodged it: "if
> you have comments, please file a bug in our bugtracker", which isn't
> the
> lowest-overhead user interface if you're honest.

It is of course possible to comment PDFs (I assume you're converting
your DocBook to PDF).  Adobe Acrobat (not their free Reader) allows
this, as do some free PDF "readers" (I use the free version of
PDF-XChange).  Of course that does not allow you to click on the "accept
this change" button and automagically get their suggested revision, if
that's what they're doing.

    Mike Maxwell
    University of Maryland

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org