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 :
بازگشت