Re: [docbook-apps] DocBook content review process/tools?

[Dave Pawson <dave.pawson@gmail.com>]

https://web.hypothes.is/

AFAIK - meant to 'comment' on html (and could be used that way.)
  Unsure if you want to mark up / comment on XML or some more 'user
friendly' version
of same?

Just a suggestion.

Dave
On Tue, 23 Oct 2018 at 17:53, Peter Desjardins
<peter.desjardins.us@gmail.com> wrote:
>
> Hi! Does anyone have a document content review process you can
> recommend? One that allows non-DocBook users to easily provide input
> and see each other's comments?
>
> My team uses Google docs for content review because reviewers can
> comment easily and see each other's input (this is at a company that
> uses Google email/docs). It's error-prone and tedious to transform
> DocBook content to Google documents though. I would love to find a
> better solution.
>
> We keep content in GitHub and I love the pull request content review
> tools there. Most of our subject matter experts do not use GitHub
> though, and it's not practical to review all DocBook content by
> reading the source XML.
>
> The conversion to Google doc format that works the best for us (so
> far) is DocBook > HTML > LibreOffice OpenDocument > Upload to Google
> drive and convert to Google doc format. We lose important formatting
> like bold for guilabel elements and bullet characters for
> itemizedlists disappear. Preparing a document for review is painful.
>
> Do you have a great DocBook-based review process?
>
> Thanks!
>
> Peter
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>


-- 
Dave Pawson
XSLT XSL-FO FAQ.
Docbook FAQ.