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

[Peter Desjardins <peter.desjardins.us@gmail.com>]

Thank you, all! Your ideas are extremely helpful!

Peter
On Wed, Oct 24, 2018 at 4:08 AM Camille BÃgnis <camille@neodoc.biz> wrote:
>
> Hi Peter and all,
>
> We have developed a feature into Calenco (https://www.calenco.com) based
> on http://annotatorjs.org/ that allows anyone to comment on a Web
> version of the source file. Comments are stored server side.
> Then the technical writer have access to the same page with a list of
> all comments, who wrote it, etc.
> Do not hesitate if you need further information.
>
> Have a nice day,
>
> Camille.
>
> Le 23/10/2018 Ã 18:53, Peter Desjardins a Ãcrit :
> > 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
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>