MySQL Forums
Forum List  »  Docs

Re: Doc authoring tool
Posted by: Daniel So
Date: September 02, 2016 08:27PM

Thanks, Yves, for your kind words on the MySQL reference manual : ) 

Just to give you an idea: 
- We use DocBook (http://docbook.org/) as the schema for our XML-based authoring of the manual. 
- The DocBook source files are controlled by an SVN repository, which allows check-ins and check-outs from different sites. 
- Each writer uses his or her own favorite tool to edit the DocBook source files: some use oXygen, some use vi, and so on. And, yes, we only use tools that meet our security standards. 
- We use DocBook XSL (lightly customized) to publish in different formats. 
- We have built a whole system of scripts to handle dependencies and cross-references among the source files, and for automating our build processes. 

Hope this helps.

Daniel

Options: ReplyQuote


Subject
Views
Written By
Posted
708
August 31, 2016 02:30AM
Re: Doc authoring tool
415
September 02, 2016 08:27PM
356
September 06, 2016 03:28AM


Sorry, you can't reply to this topic. It has been closed.

Content reproduced on this site is the property of the respective copyright holders. It is not reviewed in advance by Oracle and does not necessarily represent the opinion of Oracle or any other party.