OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: DocBook content review process/tools?


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


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]