[Development] qdoc and DITA XML

[Martin Smith]

Most of you don't know that qdoc can/used to generate the Qt documentation in DITA XML format. At that time (Nokia era), we envisioned generating all the documentation in DITA XML (not just Qt), storing it in a database, and publishing subsets of it as needed using available tools. 

That was then, this is now.

We are back to using qdoc's HTML output generator to generate the Qt documentation, mostly, I suppose, because the process of generating the docs that way is simpler. We still have the DITA XML output generator, and I have tried to keep it current in parallel with the HTML output generator, but I doubt that its output is completely consistent with the HTML. In other words, no one is looking at the DITA XML output to see if it is correct.

Also, the QML documentation in DITA was generated using the C++ specialisation of DITA, because there was no QML specialisation of DITA at that time. Just before we left the burning platform, we did get QML dtd's for DITA, but we never got around to converting qdoc to use the QML specialisation.

We would like to officially stop supporting the DITA output generator and remove it, so if anyone is using it, please reply to me or Topi Reiniö.

martin smith
 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20130614/c1e47d31/attachment.html>