메시지 기반 문서화 프로세스 모델 및 지원도구 = Message-Based Documentation Process Model and Supporting Tool

국문 초록 (Abstract)

CASE도구의 일부로 제공되는 기존의 소프트웨어 문서화 도구들은 개발자들을 위한 편리한 기능을 제공했지만, 문서화 참여자 사이의 상호작용 및 정보교환을 효과적으로 지원해주지 못했다. 개발자들 사이의 의사 소통 채널의 효율성 및 질은 소프트웨어의 성공적인 개발에 중요한 영향을 미치는 요소이며, 이는 문서화에 있어서도 예외가 아니다. 상호작용 및 정보교환 지원의 미비로 인한 문서화 참여자들의 의사소통 부족은 문서 사이의 불일치, 누락, 문서내용의 모호함 등을 초래하여, 결과적으로 문서의 품질을 저하시킨다.
본 논문에서는 메시지 기반 문서화 프로세스 모델(Message-based Documentation Process model:MDP모델)을 제안하고 상호작용 및 정보교환을 지원하는 문서화 도구(Message-based Documentation Management System:MDMS)를 설계 및 구현하였다. 메시지 기반 문서화 도구에서는 문서 상태와 사건에 따라, 필요한 메시지를 구성하여 이를 자동으로 전송함으로써, 문서화 참여자들 사이의 상호작용 및 정보교환을 효과적으로 지원한다. MDMS는 메시지의 자동 전송으로 문서화 도중에 개발자가 직접 메시지를 작성하던 번거로움을 줄일 수 있으며, 문서 변경과 삭제로 인해 발생하는 문서 사이의 불일치를 줄임으로서 문서의 일관성을 향상시킬 수 있다.

다국어 초록 (Multilingual Abstract)

The conventional software documentation supporting systems embedded in CASE tools have provided convenient environments for team members to create and edit documents, but those systems were lack of interaction and communication facilities during documentation process. The quality and efficiency of communication channel between team members is an important factor for the success of software development. A lack of communication causes inconsistency between documents, unspecified parts, ambiguities, so that the software document quality is highly decreased. In this paper, we propose a documentation process model:MDP model(Message-based Documentation Process model). Based on MDP model, we design and implement a documentation supporting tool: MDMS(Message-based Documentation Management system) which enables team members to communicate and interact with each other during software documentation. In MDMS, messages are sent semi-automatically to team members by client message agents which determine the document content and receiver according to the status and event of documents. The advantage of MDMS is to reduce time and cost spent in sending messages manually and increase consistency between documents.

목차 (Table of Contents)

• 1.서론
• 2.관련연구
• 2.1.문서화 프로세스 모델
• 2.2.문서화 지원도구
• 3.메시지기반 문서화프로세스 모델
• 3.1.문서화 참여자
• 3.2.문서 상태 및 이벤트
• 4.MDP모델에서의 변경 관리 방법
• 4.1.문서간 연관성의 표현
• 4.2.변경 관련 방법
• 5.지원 도구의 설계 및 구현
• 5.1.메시지 에이전트
• 5.2.시스템 구성
• 5.3.시스템 처리 흐름
• 5.4.적용예
• 6.평가 및 결론
• 6.1.평가
• 6.2.결론