Create professional Docu with xml - HowTo?
-
Dear members, let me describe my topic. Today, our SW in my company is documented via MS-Word. With all the disadvantages with maintenance. Typical examples: 1) Docu which is provided by tools via xml is hard to include. 2) There is no automatic update possible. I would prefer to have all my documentation in an intermediate level (with formatting info) at xml and in the next step I transform it e.g. via xslt to html, pdf or anything else. This is similar to what Latex did/does. But there is a problem. It is hard to enter documentation in xml, because there is no wysiwyg-feature. Most people hate it to enter documentation in an xml-file. My Question: Is there any "easy-to-do-way" how to solve my problem - even by people who are no xml-experts? How is professional documentation managed today with automation? Thank you
-
Dear members, let me describe my topic. Today, our SW in my company is documented via MS-Word. With all the disadvantages with maintenance. Typical examples: 1) Docu which is provided by tools via xml is hard to include. 2) There is no automatic update possible. I would prefer to have all my documentation in an intermediate level (with formatting info) at xml and in the next step I transform it e.g. via xslt to html, pdf or anything else. This is similar to what Latex did/does. But there is a problem. It is hard to enter documentation in xml, because there is no wysiwyg-feature. Most people hate it to enter documentation in an xml-file. My Question: Is there any "easy-to-do-way" how to solve my problem - even by people who are no xml-experts? How is professional documentation managed today with automation? Thank you
There's SandCastle[^] and take a look at this[^] article about using NDoc. [edit]Assuming you're using C#. Not sure if C++ or VB supports this stuff. [/edit] Marc
Available for consulting and full time employment. Contact me. Interacx