• 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