DocumentCode
2001953
Title
Building DITA-based CMS as integrated documentation environment
Author
Sakai, Masayuki ; Okuno, Takashi
fYear
2012
fDate
20-24 Nov. 2012
Firstpage
1816
Lastpage
1820
Abstract
General software documents have some problems with traceability and maintenance. This study aims to solve those problems by using DITA, an XML-based architecture for authoring technical documents. In DITA architecture, documents consist of topics and maps. Topics have small amount of information which can reuse, and maps specify contents of each output by organizing topics. It is difficult to break down general documents into reusable topics. In this paper, granularity of topics are defined. As a result of analysis of software documents, it was found that there are three types of structures in software documents, and those need to be broken down into different-sized topics. Besides, a CMS as a software documentation environment is needed for software documentation using DITA. Functions required for the CMS are considered.
Keywords
XML; authorisation; content management; program diagnostics; software maintenance; system documentation; DITA architecture; DITA-based CMS; Darwin information typing architecture; XML-based architecture; content management system; integrated documentation environment; software document maintenance; software document traceability; software documentation environment; technical document authorisation;
fLanguage
English
Publisher
ieee
Conference_Titel
Soft Computing and Intelligent Systems (SCIS) and 13th International Symposium on Advanced Intelligent Systems (ISIS), 2012 Joint 6th International Conference on
Conference_Location
Kobe
Print_ISBN
978-1-4673-2742-8
Type
conf
DOI
10.1109/SCIS-ISIS.2012.6505054
Filename
6505054
Link To Document