Title :
An automatic documentation generator based on model-driven techniques
Author :
Wang, Chao ; Li, Hong ; Gao, Zhigang ; Yao, Min ; Yang, Yuhao
Author_Institution :
Coll. of Comput. Sci., Zhejiang Univ., Hangzhou, China
Abstract :
Software documentation is very important in the process of software maintenance. In this paper, we propose a new methodology for automatic documentation generation, which is capable of maintaining the consistency between software documentation and the corresponding software system in model-driven development. We first set up the documentation model, and then map system model elements to documentation model elements. Finally, we combine the documentation model with specific document format templates and generate the “requirements specification”, “preliminary design specification” and “detailed design specification”. An automatic transmission system is used to provide experimental results to demonstrate the engineering value of our documentation generator. In addition, we analyze and experimentally evaluate the factors affecting the document generation time, and provide a method for predicting the document generation time.
Keywords :
formal specification; software maintenance; system documentation; automatic documentation generator; automatic transmission system; detailed design specification; document format template; model-driven development; preliminary design specification; requirement specification; software documentation; software maintenance; software system; Chaos; Character generation; Computer science; Documentation; Educational institutions; Graphical models; Information representation; Programming; Software standards; Unified modeling language; documentation generation; documentation model; map; model-driven;
Conference_Titel :
Computer Engineering and Technology (ICCET), 2010 2nd International Conference on
Conference_Location :
Chengdu
Print_ISBN :
978-1-4244-6347-3
DOI :
10.1109/ICCET.2010.5485654