MHonArc v2.5.0b2 -->
















dita message






[Date Prev]
 | [Thread Prev]
 | [Thread Next]
 | [Date Next]

--

[Date Index]
 | [Thread Index]
 | [List Home]








Subject: Compound Documents




From: france.baril@ixiasoft.com
To: dita@lists.oasis-open.org
Date: 4 May 2004 17:49:25 -0000






Following the discussion on compound documents, I wanted to share how I used DITA in a process to publish technical documentation from non-DITA xml sources.

I have to document Web Services (WS) in my current project. My basic sources of information are WSDLs and comments extracted from C# code (method, parameter descriptions) that are in a non-DITA XML format.

To document WS Operations I transform my WSDLs into multiple DITA reference documents (one for each operation and one for a general overview of the WS), and I add the operation and parameter descriptions from the C# xml documentation files. I also automated the process of buiding a DITA map from WSDL files.

I'm about to use a similar process for documenting the XML schemas used by the WS.

Basically, my point is that using DITA is a also good way to put together pieces of information from non-DITA sources. It could be interesting to propose DITA as a way to solve some of the issues related to creating compound outputs.

France













[Date Prev]
 | [Thread Prev]
 | [Thread Next]
 | [Date Next]

--

[Date Index]
 | [Thread Index]
 | [List Home]